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Need to demonstrate what your 
software can do? 



The Demo Builder for Windows 


TVThen you can’t be 
rtf there to demonstrate 
a program yourself,,Dan 
Brick tin’s demo-it! makes 
an effective stand-in 

PC Magazine 
April 11,1995 



Whether you’re in sales, marketing or development, demo-it! will show off your product when 
you’re not there. Need to give away demos at your upcoming trade show? Need to post demos 
on the Internet? Well now you can, with demo-it! 


No time to learn an authoring tool? No problem! 

You need to create a demo to show off your software, and you need 
it yesterday. You don’t have time to learn an authoring tool—all you 
want is to create an effective sales tool. Since demo-it! requires NO 
programming, has great online help and informative documentation, 
you can create a professional-looking demo quickly. 


Whatever kind of demo you want is what you get with demo-it! 

Quickly put together sales presentations. Produce electronic brochures for potential customers. Create 
self-running demos. Upload an interactive demo to the Internet. Supply your in-house staff with tutorials. 
Promote sales with disk-based advertising. 


/ y i 
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SUPPORT/ 


Just look at some of the features: 

Version 2.0 of demo-it! is even more feature-rich than the best-selling Version 1.0. i 

■ Enhanced special effects, including Implode and Explode i ' 

■ Is completely WYSIWYG—no need for you to worry about font support 

■ Works great on disk, CD-ROMS, Internet and online services yk l) 

■ Launches external programs 

■ Has rich text support—use several fonts and styles in one object J ■ 

■ Supports variables and conditions ri 1 

■ Creates a familiar slide show about your product r 

■ Text, lines, buttons, pictures, rectangles, slides, overlays & underlays are easily created 

■ Supports events 

■ Has actions such as next slide, previous slide, go to slide, play a .WAV file, run a program, etc. 

■ Has a screen capture utility with many features 

■ Runs demos direcdy from floppy disk—no need for users to change their hard drives 

■ Comes with a freely distributable 170K runtime player 

■ Creates small, compact demos. 
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THE POWER TO DEVELOP YOUR IDEAS 

Dan Brkklin's is a registered trademark of Daniel S. Bricklin. demo-it! is a 
registered trademark of Lifeboat Publishing. Windows is a registered trademark of 
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Let's face it - when you need a disassem¬ 
bler you're looking for clear, reliable informa¬ 
tion. Those who have tried other products 
have been disappointed with the dismal re¬ 
sults. 

Clearly, a new standard of excellence! 

Sourcer solves these problems with ad¬ 
vanced analysis and simulation. The quality 
of output is so good that most DOS EXE & 
COM files and drivers reassemble perfectly, 
byte-for-byte identical to the original! 

To make the results easier to understand 
Sourcer provides detailed and descriptive 
comments for interrupt subfunctions, I/O 
ports and much more. Sourcer even lets you 
examine encrypted and packed programs. 


mov 

ax,2517h 


mov 

dx.offset int 17h entry 

int 

21 h 

; DOS Services ah=function 25h 
; set intrpt vector al to ds:dx i 

; (’Halt when ? printed.') 

mov 

dx.offset data 4 

mov 

ah ,9 



21 h 

: DOS Services ah=function 09h 



; display char string at ds:dx 

mov 

dx,19h 


mov 

ah,31h 



; DOS Services ah=function 31 h 



; terminate and stay resident 
; al=return code,dx=paragraphs 

virustst endp 




int_17h_entry proc 
pushf 

far 

Push flags 

cmp 

al,3Fh 



Partial Disassembly of a Virus 

C/C++ and Pascal 

Some C. C++ and Pascal developers hate 
disassembly because the source code they get is 
assembly. We can’t change that, but we can 
make it easier for you by automatically identi¬ 
fying the use of parameter passing and local 
stack variables. Parameters pushed onto the 
stack prior to a subroutine call are clearly com¬ 
mented. 

Get commented BIOS listings 

The BIOS Pre-Processor creates commented 
listings for any BIOS ROM. Understand how 
your specific BIOS works! Adds over 75K of 
comments specific to your BIOS. Inserts labels 
like "int_10_video". Andifsfully automatic. 
Windows disassembly! 

Windows Source generates detailed listings 
of Windows EXEs, DLLs, VxDs, device 
drivers, & OS/2 NE files. Windows Source 
labels, by name, export & import function calls, 
API calls like "GetModuleHandle", undocu¬ 
mented APIs, VxD functions and much more. 

Call now! 
1 - 800 - 648-8266 

Sourcer $149.95 

Sourcer & BIOS Pre-processor 189.95 

Sourcer & Windows Source 249.95 

Sourcer, BIOS & Windows Source 289.95 

Shipping: USA $6; Canada/Mexico $10: All others $25, 

CA residents add sales tax. © 1994 VISA/MC/Amex/COD 

30-DAY MONEY-BACK GUARANTEE 
V Communications, Inc. 

4320 Stevens Creek Blvd., Suite 120-WD 
San Jose, CA95129 408-296-4224 
FAX 408-296-4441 
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I’ve been getting email somewhat faster than I have time to answer, so I apologize in 
advance if you get a weeks-late response. AT Vendors: make sure you send your 
press releases to one of the addresses listed in each month’s New Products section. 
Press releases sent directly to me invariably get lost. AT This month’s “Understanding 
NT” visits the topic of services again. I’ve seen several people asking why they can’t 
use MFC when writing a service. I don’t know the exact answer, but I suspect MFC is 
just doing too many things behind the scenes at startup that will cause your service 
problems. For example, trying to access HKEY_CURRENT_USER in the registry will be a 
problem. And of course, the service control manager will want to start your service 
thread with CreateThread(), not with _beginthreadl). And who knows what new 
things the next version of MFC will do at startup? All in all, MFC seems like more trou¬ 
ble than it’s worth for this particular task. AT I’ve been working on a small, simple 
DLL of reusable code for some time, and I can’t believe how hard it’s been. The prob¬ 
lem is, I want dual versions of the DLL (Win 16 and Win32) with identical interfaces, 
UNICODE-enabled, that work correctly with either Borland or Microsoft apps. My 
most recent fun discovery is that you’d better think twice before you use 

__decl spec(thread) in a DLL. If you do use this handy construct to get thread-local 

data, then Load Li b ra ry () will fail if anyone attempts to explicitly load your DLL. Isn’t 
that a cool feature? The function fails with an error code that indicates that your DLL’s 
startup code failed, but in fact, your DLL’s startup code never gets invoked. Wouldn’t it 
make sense to document this fact somewhere like, I don’t know, maybe the online help 
for Load Li bra ry ()? Naw, that would make life too easy! AT I’m actually writing this 
column in December, while pondering what my New Year’s resolutions should be. At 
the top of the list is: I will author (or at least co-author) my first programming book in 
1997. Of course, I’ve had that resolution for several years, but I think this is the year it 
will really happen. After years of savaging other folk’s books in my column, it’s time to 
answer that eternal question — can I do any better? I’ll try to slip in a shameless plug 
here when it’s done. AT When I installed Windows 95, I said “no” to most of the 
accessories. It turns out that there were a couple of useful ones in there I was missing 
out on. In particular, there’s a system monitor that can display graphs of various system 
statistics as a function of time, such as disk I/O, memory, and so on. I learned this, as 
usual, from a reader. He plans to deliver a VxD/DLL combo that makes it easy for any 
app to display its own statistics. Stay tuned, it should appear along about April or May. 
AT Our "Database Programming” theme is coming up in October. That sounds like a 
long ways off, but we always have trouble coming up with good WDT-style articles for 
that theme. If you’ve got a database-related idea you’re interested in writing about, or 
even ideas you want to see someone else write about, drop me a line at 
70302.2566@C omp userve. com. AT One interesting thing I’ve learned from our new 
“Reader Profile” series is that IDE integration may be an important feature for any 
programming tool. That’s not necessarily good news for tool vendors, to whatever extent 
it’s true. Borland at least takes a weak stab at documenting the ways you can tightly inte¬ 
grate a product with their IDE, but I’ve been unable to find any documentation on how to 
integrate with Visual C++. The question of the month is: how important is it to you that 
any programming tool you buy be well-integrated with your compiler’s IDE? 

Ron Burk, Editor 

70302.2566@compuserve.com 

http://ourworld.compuserve.com/homepages/RonBurk 
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Save months of TCP/IP programming! 


Fill in properties 



■r- * • 

• • • m m m 

Write a little code 





OLE Custom Controls 

Just ask any OCX jockey. With Distinct’s Visual Internet 
Toolkit, adding TCP/IP connectivity to your application 
is not much farther than a drag-and-drop away. 
Whether you need a customized FTP client or most 
any other Internet application, you can simply embed 
an OCX into your program and Visual Internet 
will do the rest. It’s that easy. And you’ll have 
great looking, powerful applications. 


Protocols 

• Windows Sockets 

• Telnet 

• TCP/UOP/ICMP 

• VT 220 

• PPP/SLIP/CSLIP 

• WinSNMP 

• E-mail/SMTP 

• ONC RPC/XDR 

• POP 2/POP 3 

• rep 

• News/NNTP 

• rexec 

• FTP 

• rlogin 

• TFTP 

• rsh 

• TCP Server 

• And many more 

Interfaces* 

Environments 

•32 bit (95 and NT) 

• Visual Basic 

• 16 bit (Windows 3.x) 

• Visual C/C++ 

• C++ Class libraries 

• Delphi 

• DLL's 

• C/C++ 

• OCX's 

• Access 

• VBX’s 

• FoxPro 


32 Bit Performance 

The power of our new 32 bit Visual Internet Toolkit 
is simply unsurpassed. More custom controls. More 
protocols. More sample code. More Documentation, 
Which makes your job easier and leaves the 
competition in the dust. 



u 408.366.8933 


World Wide Web: http://www.distinct.com 
Fax: 408.366.0153 

E-mail: windev@distinct.com 

Fastfacts: 408.366.2101 


•Nol all Interfaces mar be available for all protocols, licensing fees required for redistribution. Distinct is a registered trademark and 30 minute Internet Delivery! and Visual Internet is a trademark of the Distinct Corporation. Copyright 1995 Distinct Corporation, 12900 Saratoga Avenue, Saratoga, CA 95070. .All rights reserved. Specifications and delivery terms are subject to change without notice. 
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Paula Tomlinson 



“Device drivers can 
send IOCTL 
commands to other 
device drivers, just as 
applications do, 
though it is not as 
easy as calling 
DeviceloControlQ. 
Some programmers 
actually create filter 
drivers to obtain 
information that they 
could more easily 
obtain via an IOCTL 
command. That’s a 
risky practice, since a 
bug in a filter driver 
usually is capable of 
causing many more 
problems than a bug 
in code that just 
sends an IOCTL 
command.” 


Paula Tomlinson has been developing DOS, 
Windows, and Windows-NT based applications 
and device drivers for nine years. The opinions 
expressed here are hers alone. She can be con¬ 
tacted via the Internet at paulat@microsoft.com. 


Sending lOCTLs to Windows NT 
Drivers 

NT device drivers respond to a simple set of file-oriented commands: open, read, write, 
and close. The NT device driver model supports another command, however: the IOCTL 
(I/O Control) command. A driver can make available most any custom functionality via an 
IOCTL command. Many standard Windows NT device drivers provide IOCTL (I/O Control 
Code) command functionality in addition to the basic device read/write support. These 
IOCTL commands can sometimes be very useful to applications as well as to other drivers. 
For example, the NT floppy drive device driver supports an IOCTL command that reports 
whether or not a floppy is currently inserted in the drive. For file-oriented commands (e.g., 
open, read, write, and close), an NT application can use familiar functions such as 
ReadFileO and WriteFileO. Sending an IOCTL command, though, requires calling the 
somewhat less familiar Win32 function Devi celoControl (). 

Device drivers can send IOCTL commands to other device drivers, just as applications 
do, though it is not as easy as calling Devi celoControl (). Some programmers actually cre¬ 
ate filter drivers to obtain information that they could more easily obtain via an IOCTL com¬ 
mand. That’s a risky practice, since a bug in a filter driver usually is capable of causing many 
more problems than a bug in code that just sends an IOCTL command. 

This article demonstrates IOCTL commands from the perspective of both applications 
and drivers. I will demonstrate three aspects of IOCTL commands: 

• How to support IOCTL commands in your own device driver. 

• How to send an IOCTL command to another driver from your device driver. 

• How to send an IOCTL command to a device driver from an application. 

To demonstrate these concepts, I wrote a simple application and a simple Windows NT device 
driver that communicate via a custom-defined IOCTL. When the application sends an IOCTL 
command to the driver, the driver in turn sends a different IOCTL command to one of the stan¬ 
dard built-in Windows NT drivers. This demonstrates how applications send IOCTL commands 
to drivers and how drivers send IOCTL commands to other drivers. It also provides a template 
for adding IOCTL commands to your own drivers. In practice, the application could just send an 
IOCTL directly to the second driver, but this example is contrived to demonstrate all three con¬ 
cepts. You will need the Windows NT DDK to build the examples in this article. 

Defining the Custom IOCTL Value 

When you decide that your device driver will support an operation via an IOCTL com¬ 
mand, you must define a command code that callers can use. wdj. h (Listing 1) contains the 
definition of my custom IOCTL command code. Any other application or driver that wants 
to issue this IOCTL to my driver will #i ncl ude this file. 

The actual IOCTL command value is a bitmask that contains several pieces of informa¬ 
tion. I used the CTL_C0DE macro (defined in winioctl ,h for applications and ntddk. h for dri¬ 
vers) to define the custom command 1 0CTL_WDJ_REQU EST for my sample driver. The first 
argument to CTL_C0DE is a value that describes the device type. NT defines several standard 
device types (such as FI LE_DEV I CE_D ISK for persistent storage devices), but my sample driver 
doesn’t really fit any of the predefined device categories, so I defined a new device type value 
of FI LE_DEVICE_WDJ. Note that since this is an “OEM” device (rather than a standard device 
type defined by the operating system), I must use a value in the range 0x8000 to OxFFFF. 

The second argument of the CT L_CODE macro identifies the specific IOCTL command. 
When a driver supports more than one custom IOCTL command, this value must be different 
for each command. Since 1 0CTL_WDJ_REQUEST is a custom IOCTL command (rather than a 
standard IOCTL command, such as IOCTL_FORMAT_DISK_TRACKS, that is supported by a 
whole category of device drivers), I’m required to use a value in the range 0x800 to OxFFF to 
define my IOCTL command. The third argument describes the type of data transfer; 
METH0D_BU FFERED is a typical choice for drivers that transfer a small amount of data. The final 
argument describes what kind of access the application must specify when opening a handle 
to this device. A value of FI LE_ANY_ACCESS means the caller can open a handle to this device 
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Ultimat e TCP/IP 

Internet/intranet Client and Server Development Kit 


Windows is a registered trademark of Microsoft Corp. All other products are trademarks or registered trademarks of their respective owners. 
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^ POP3 
a' SMTP 
a' HTTP 


Ultimate TCP/IP allows you to design full-featured, 
powerful FTP, HTTP, DNS, Finger, SMTP/POP3 
applications, as well as proprietary protocols quickly 
and easily! Modify our sample server and client code 
to get exactly what you want instantly! Easily create 
multi-threaded Internet server applications that run 
as true Windows NT services. 


1 800 463 1492 

Sales: 416 239 7472 
Fax: 416 239 2183 

EMail: sales@dundas.com 
WWW: www.dundas.com 


^ FTP 
s' DNS 
s' And More 


• 30 day money-back satisfaction guarantee. 

• Visa, MasterCard, American Express, check, money order. 

• We will deliver via Internet, CompuServe, mail or courier. 

• All prices in US dollars 


Dundas Software Ltd. 

• 500 - 4800 Dundas Street West, 
Etobicoke, Ontario, Canada, M9A 1B1 

• 670 - 240 Portage Rd., Lewiston, 

New York, USA, 14092 


rtundas.coM 


s' Clients and Servers 
s' Custom Protocols 
s' NT Services 


Whether you are developing for the intranet or 
internet, Ultimate TCP/IP will be your trusted 
guide. Our well-constructed C++ classes allow you 
to solve both sides of the client/server equation. 


Entry-Level 

Professional (w / full source code) 


$199.00 

$499.00 


Dundas Software 


Ultim ate Grid 

100% MFC Object Oriented Design 

The Premier Grid control for MFC/C++ development. Ultimate Grid provides an 
outstanding 100% MFC object oriented design. Unparalleled power, Unparalleled features, 
Ultimate performance. 

Solid. Powerful. Professional. 

Ultimate Grid was designed from the ground up as a solid, professional tool to satisfy your 
development needs. Based on powerful MFC classes, Ultimate Grid can be easily used as a 
CWnd, C View, CDialog, dialog resource, or a pop-up! 

Ultimate Grid includes all the features you expect, and an extensive list of powerful new 
features you can depend on. It connects easily to standard data sources such as DAO, 
ODBC, SQL, CodeBase, and c-tree plus. And, you can very easily connect to proprietary or 
other 3rd party databases, or use the built-in memory manager for pre-loading. 

The professional edition includes full source code and allows you to develop custom data 
sources and new cell types, gives you enhanced debugging capability and greater 
development flexibility. 

Ultimate Grid compiles right into your app; no ActiveX control or DLL to include! It's 100% 
Royalty-free, just like all Dundas products, and includes a 30 day money-back guarantee. 

Call today, or visit our WWW site and find out for yourself why developers the world over are 
flocking to Ultimate Grid and making it the cornerstone of their development projects. 

Entry-Level $149.00 

Professional (w/ full source code) $349.00 

Generic C++ and ActiveX versions are also available. Call or visit our Web site for full details. 









with any access rights and still be able to send the 
IOCTL_WDJ_REQUEST command via that file handle. 


Listing 2: wdj.c — A simple NT device driver 


The Sample Driver 

The sample driver code is in wdj.C (Listing 2). This driver has only 
two requirements: it must support the IOCTL_WDJ_REQUEST command 
and it must demonstrate how to send an IOCTL command from one 
driver to another driver. To demonstrate how one driver sends an 
IOCTL to another, I needed to find a standard NT device driver that 
accepts some useful IOCTL command. For my target driver I chose 
the standard Windows NT floppy driver, because nearly all computers 
have at least one floppy device and the consequences of accidently 
sending an errant command to the floppy driver are not usually cata¬ 
strophic. You should be able to experiment with this sample driver 
on your own system. 


Listing 1: wdj.h — Defining an IOCTL command 


II 

// Microsoft uses 0 - 0x7FFF, OEMs use 0x8000 - OxFFFF 
// 

//define FILE_DEVICE_WDJDRV 0x00009500 
// 

// Microsoft uses function codes 0-0x7FF, OEM's use 0x800 - OxFFF 
// 

//define WDJ_I0CTL_INDEX 0x950 


// wdj.c 

//include "ntddk.h" 

//include "ntdddisk.h" 

//include "wdj.h" 

typedef struct _DEVICE_EXTENSI0N { 

PDEVICE_0BJECT NextDeviceObject; 

} DEVICE.EXTENSION, *PDEVICE_EXTENSI0N; 

NTSTATUS WdjDrvDispatchCIN PDEVICE.OBJECT, IN PIRP); 
VOID WdjDrvUnload(IN PDRIVER_0BJECT); 


NTSTATUS DriverEntrydN PDRIVER_0BJECT DriverObject, 

IN PUNIC0DE_STRING RegistryPath) 

{ 

NTSTATUS status = STATUS_SUCCESS; 

PDEVICEJBJECT deviceObject - NULL; 

UNIC0DE_STRING deviceName, dosName, f1oppyName; 

PDEVICE_EXTENSION deviceExt - NULL; 

PFILE_0BJ ECT fileObject = NULL; 

// 

// Create an EXCLUSIVE device object. 

// 

Rtl InitUnicodeString(&deviceName, L”\\DeviceWWdjDrv"); 

status - IoCreateDevice(DriverObject, sizeof(DEVICE_EXTENSI0N), 
&deviceName, FILE_DEVICE_WDJDRV, 

0, TRUE, &deviceObj ect); 


if (!NT_SUCCESS(status)) { 
return STATUSJNSUCCESSFUL; 

} 


//define I0CTL_WDJ_REQUEST CTL_CODE(FILE_DEVICE_WDJDRV, \ 
WDJJOCTLJNDEX. \ 

METHODJUFFERED, \ 

FILE_ANY_ACCESS) 

/* End of File */ 


// 

// Create a symbolic link that Win32 apps can specify to gain 
// access to this driver/device 
// 

Rtl Ini tUni codeStri ng(&dosName, L”\\DosDevi cesWWDJDRV"); 
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The standard initialization entry point for all Windows NT device 
drivers (except certain layered drivers such as SCSI miniport drivers) 
is Dri verEntry (). In Dri verEntry (), a device driver typically creates 
one or more device objects to represent physical or logical devices. My 
sample driver doesn’t actually talk to any real devices, so I create a sin¬ 
gle logical device object (“\\device\wdjdrv”) by calling 
IoCreateDevi ce( ). Device objects typically have names of the form 
“\\device\Xxx”. This doesn’t really give my sample application some¬ 
thing to talk to yet, though, because device object names are not direct¬ 
ly accessible to user-mode applications. I need to create a symbolic 
link between my device object and a name that is visible to user-mode 
applications by calling IoCreateSymbol icLi nk( ). Symbolic link 
names have the form “VDosDevicesYXxx". When an application pass¬ 
es the symbolic link name to CreateFi 1 e( ) and then sends read, write, 
or IOCTL commands to that file handle, the requests are routed to my 
driver, because my driver created the target device object. Since a dri¬ 
ver can create multiple device objects, drivers usually use the private 
device extension area of the device object to store any information that 
may need to be retrieved in order to carry out the read, write, or 
IOCTL command request. 

My driver also needs to send IOCTL commands to a device driver 
(the floppy driver), but NT device drivers don’t have access to the 
Win32 API, so my driver can’t call CreateFi 1 e() to obtain a handle. 
Moreover, the symbolic links that applications use to open devices rep¬ 
resent a namespace that drivers don’t have access to. Instead, my dri¬ 
ver must use a DDK function to obtain a handle to one of the device 
objects that represent a physical floppy drive. The floppy driver creates 
device objects of the form “Wdevice\floppyX”, where “X” is “0” for 
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Listing 2: wdj.c — continued 


status - IoCreateSymbolicLinkC&dosName, &deviceName); 

if (!NT_SUCCESS(status)) { 

DbgPrint("WDJ.SYS: create symbolic link fai1ed\n”); 
IoDeleteDevice(deviceObject): 
return STATUSJNSUCCESSFUL; 


deviceExt - (PDEVICE_EXTENSION)deviceObject->DeviceExtension; 

// 

// Get a device object pointer to floppy device 0 and save it in 
// the device extension for use later. 

// 

RtlInitUnicodeString(&f1oppyName. L"\\Device\\FloppyO"); 

status - IoGetDeviceObjectPointer(&floppyName. FILE_ANY_ACCESS. 

&fi1eObject. 

&deviceExt->NextDeviceObject); 


if (!NT_SUCCESS(status)) { 

DbgPrint("WDJ.SYS: get device object fai1ed\n”); 

IoDeleteSymbolicLink(SdosName); 

IoDeleteDevice(deviceObject); 
return STATUSJNSUCCESSFUL; 

} 

ObDereferenceObject(fi1eObject); 

// 

// Create dispatch points for device control, create, close. 

// 

DriverObject->MajorFunction[IRP_MJ_CREATE] 
DriverObject->MajorFunction[IRP_MJ_CLOSE] 

DriverObject->MajorFunction[IRP_MJ_DEVICE_CONTROL] - WdjDrvDispatch; 
DriverObject->DriverUnload - WdjDrvUnload; 

return status; 

} // DriverEntry 


NTSTATUS WdjDrvDispatch( IN PDEVICEJBJECT Devi ceObject. 

IN PIRP Irp) 

{ 

NTSTATUS status; 

PIO_STACK_LOCATION irpStack; 

PDEVICE_EXTENSION deviceExt; 

PVOID ioBuffer; 

ULONG inLength; 

ULONG outLength; 

ULONG ioctl; 

irpStack - IoGetCurrentlrpStackLocation(Irp); 
deviceExt - DeviceObject->DeviceExtension; 

Irp->IoStatus.Status - STATUS.SUCCESS; 

Irp->IoStatus.Information - 0; 

// 

// Get the pointer to the input/output buffer and it's length 
// 

ioBuffer - Irp->Associatedlrp.SystemBuffer; 
inLength - irpStack->Parameters.DeviceloControl.InputBufferLength; 
outLength - irpStack->Parameters.DeviceloControl.OutputBufferLength; 

switch (irpStack->MajorFunction) { 

case IRP_MJ_CREATE: 

DbgPrint("WDJ.SYS; IRP_MJ_CREATE\n"); 
break; 

case IRP_MJ_CLOSE: 

DbgPrint("WDJ.SYS: IRP_MJ_CLOSE\n"); 
break; 

case IRP_MJJEVICE_C0NTR0L: 

DbgPrint("WDJ.SYS: IRP_MJ_DEVICE_CONTROL\n"); 

ioctl - irpStack->Parameters.DeviceloControl.IoControlCode; 

switch (ioctl) { 

case IOCTL_WDJ_REQUEST: { 

PIRP Newlrp; 

IO_STATUS_BLOCK IoStatusBlock; 

KEVENT Event; 

ULONG media - OxFFFFFFFF; // unknown 

if (outLength < sizeof(ULONG)) { 

Irp->IoStatus.Status - STATUS_BUFFER_TOO_SMALL; 
break; 

} 
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the first floppy device, etc. My driver retrieves a handle to the device 
object for the first floppy device by passing “WdevicetfloppyO” to 
IoGetOeviceObjectPointerl). IoGetDeviceObjectPointer() 
returns a pointer to both a file object and a device object for 
“\\device\floppyO”; since I only need the device object, I save it in my 
device extension area and dereference the file object. 

Finally, my driver fills out the dispatch routine table in the 
device object before exiting Dri verEntryl ). The I/O system uses 
the dispatch routine table to route I/O requests targeted for my 
device object to the appropriate routine within my driver. When an 
application attempts to open, close, read, write, or send IOCTL 
commands to the symbolic link for my device object, the I/O system 
packages that request into an IRP (I/O Request Packet) and sends 
the IRP to the appropriate routine listed in the dispatch table. Since 
my sample driver doesn't really support anything other than IOCTL 
commands, I filled out only the I RP_MJ_CREATE, IRP_MJ_CLOSE, and 
IRP_MJ_DEVICE_CONTROL entries. I also provided an “Unload” rou¬ 
tine for my driver. This routine is not called in response to an I/O 
request, so it is not passed an IRP or a device object. Rather, it is 
called just before my driver is unloaded. In WdjDrvUnl oad(), I sim¬ 
ply delete the symbolic link and the device object that I created 
when the driver was initialized. 

WdjDrvDispatchO handles more than one command (create, 
close, and IOCTL commands), so it examines the MajorFuncti on 
field in the current IRP stack location to identify the command. 
Since I specified METH0D_BUFFERED as the transfer type when I 
defined the IOCTL command, any data passed by the caller can be 
found in the Associated!rp->SystemBuffer field, and any data I 
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transfer back to the caller will also be copied back into this buffer. 
Status information is communicated back to the I/O system (and 
ultimately back to the caller) by filling out the IoStatus.Status 
and IoStatus. Info rmati on fields in the IRP structure. You set the 
Status field to an NTSTATUS value that indicates whether or not the 
call was successful (STATUS_SUCC ESS), and if not, what kind of error 
occured. In my case, the Info rmati on field is filled out with the size 
of any data that I copied to the SystemBuffer. I’m not actually 
doing anything special during the create and close commands, but I 
provided code stubs in case any readers wanted to add their own 
caller-specific initialization code. 

In response to the I OCT L_WD J_REQU EST command, I need to send 
an IOCTL command to the floppy driver. Recall that I already have 
a handle to the target device object tucked away in my device exten¬ 
sion. First, I build an IRP to represent the IOCTL request for this 
device object by calling IoBui T dDeviceloControl Request (). In 
this case. I’m calling the floppy driver’s IOCTL_DISK_CHECK_VERIFY 
command, which tells me whether or not a floppy is present in this 
floppy drive. After building the IRP, I call IoCal 1 Dri ver( ) to pass 
it to the target driver. Note that since some IOCTL commands are 
handled asynchronously, callers pass a kernel-mode event handle to 
IoBui 1 dDevi celoControl RequestO; the event is signaled when 
the request completes. If the Status field is set to 
STATUS_NO_MEDI A_I N_DEV ICE on return, then I know that the floppy 
drive is empty. I copy a Boolean value to the user-mode applica¬ 
tion’s buffer to let them know whether or not a floppy is present in 
this floppy drive. Finally, to complete the original 
1 0CTL_WDJ_REQUEST command, I call IoCompl eteRequestC ) and 
then return from WdjDrvDispatchO. 

You can programmatically install the sample driver by calling 
CreateServi ce( ). For more information, see “Dynamically 
Loading Drivers in Windows NT” in the May 1995 issue of WDJ. 

The Sample Application 

Now that I’ve demonstrated how drivers send IOCTL commands 
to other drivers. I’ll show how applications send IOCTL commands 
to drivers. My sample application is app.C (Listing 3). The user¬ 
mode application must first open a handle to the appropriate device 
object by passing the symbolic link name to CreateFi 1 e( ). Recall 
that the symbolic link name created in the sample driver is 
“\\DosDevices\wdjdrv”. When passing this symbolic link name to 
CreateFi 1 e( ), you should use the form “WAwdjdrv”. It’s important 
to specify the OPEN_EX I ST ING flag so that the CreateFi 1 e () call 
will fail appropriately if the driver is not loaded. 

Once you have a handle open to the appropriate device object, 
you can send IOCTL commands to it by calling 
Devi celoControl (). Devi celoControl () is also used by applica¬ 
tions running on Windows 95 to send commands to VxDs (note that 
the format for specifying the device name in the call to 
CreateFi 1 e( ) is different for VxDs). In addition to the file handle 
and the IOCTL command value, callers can pass an input buffer 
and an output buffer to Devi celoControl (). For my custom 
1 0CTL_WD J_REQU EST command, no input buffer is required, but I do 
need to specify an output buffer that is at least large enough to hold 
the ULONG return value. Devi celoControl () supports both syn¬ 
chronous and asynchronous operation via the 1 pOverl apped para¬ 
meter. If you wish to call DeviceloControlO asynchronously, 
then the file handle must have been opened with the 
FILE_FLAG_OVERLAPPED flag. 
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As I mentioned before, this example is contrived. My sample 
application could have bypassed the sample wdj.sys driver and 
called the floppy driver directly by opening a handle to “\\.\a:” and 
then passing the IOCTL_DISK_CHECK_VERIFY command directly to 
that file handle. I introduced the complication of wdj.sys just to 
demonstrate how drivers implement IOCTL commands, and how 
drivers can pass IOCTL commands to other drivers. 

Summary 

Drivers have access to a lot of useful information and can per¬ 
form many useful tasks for applications. If a driver already supplies 
an IOCTL command that meets your needs, then it is a quite trivial 
matter for an application to call it. Likewise, drivers can sometimes 
avoid reinventing code by calling IOCTL commands in other dri¬ 
vers. If you need only to pass IOCTL commands to another driver, it 
is definitely overkill to layer yourself on top of that driver. Filter dri¬ 
vers are risky in that poorly written filter drivers can compromise 


Listing 2: wdj.c — continued 


) 


KelnitializeEvent(&Event. SynchronizationEvent. 
FALSE); 

Newlrp - IoBui1dDeviceloControlRequestC 

IOCTL_DI$K_CHECK_VERIFY, 
deviceExt->NextDeviceObj ect, 
NULL. 0, NULL, 0. FALSE. 
&Event, &IoStatusBlock); 

if (Newlrp - NULL) { 

Irp->IoStatus.Status - IoStatusBlock.Status; 
break; 

) 

status - IoCal1Driver(deviceExt->NextDeviceObject. 
Newlrp); 

if (status — STATUS.PENDING) { 

KeWaitForSingleObject(&Event. UserRequest, 
UserMode. TRUE. NULL); 

) 

if (IoStatusBlock.Status — 

STATUS_N0_MEDIA_IN_DEVICE) { 
media - FALSE; 

} else if (IoStatusBlock.Status — 
STATUS.SUCCESS) { 
media - TRUE; 


RtlCopyMemory(1oBuffer, &media, sizeof(ULONG)); 
Irp->IoStatus.Information - sizeof(ULONG); 
break; 


} 


default: 

DbgPrint("WDJ.SYS: unknown I0CTL\n”); 
Irp->IoStatus.Status - STATUS_INVALID_PARAMETER; 
break; 


break; 


status - Irp->IoStatus.Status; // save before releasing irp 
IoCompleteRequestdrp, I0_N0_INCREMENT); 

return status; // no pending ops, return status 

} // WdjDrvDispatch 


VOID WdjDrvUnload(IN PDRIVER_0BJECT DriverObject) 
: { 

UNICODE_STRING unicodeString; 


// 

// Delete the symbolic link and the device object. 

// 

RtlInitUnicodeString(&unicodeString. L”\\DosDevices\\WDJDRV"); 
IoDeleteSymbolicLink(&unicodeString); 

IoDeleteDevice(DriverObject->DeviceObject); 


} // Wdj Unioad 
/* End of File */ 


the functionality of the driver on which they are layered. It is much 
simpler and safer in this case to get a pointer to the device object, 
build an IRP, and send it to the driver when necessary. □ 


[Download the code from WWW. wdj .com/ source. htm.J 


Listing 3: app.c — Sending IOCTL commands 


// app.c 

♦include <windows.h> 

♦include <winioctl.h> 

♦include <stdio.h> 

♦include "wdj.h" 

VOID _cdecl main(void) 

{ 

HANDLE driver; 

ULONG value - 0. size - 0; 

driver - CreateFIle("\\\\.Wwdjdrv". GENERIC.READ | GENERIC_WRITE, 
0. NULL. OPEN.EXISTING, FILE_ATTRIBUTE_N0RMAL. 
NULL); 

if (driver — INVALID_HANDLE_VALUE) { 

printfC'Error opening wdj Driver (%d)\n", GetLastErrorO); 
return; 

} 

if (IDeviceloControl(driver. (ULONG)I0CTL_WDJ_REQUEST, NULL. 0. 

&value, sizeof(ULONG). &size. NULL)) { 

printf("I0CTL_WDJ_REQUEST failed (Xd)\n". GetLastErrorO); 
return; 

} 

CloseHandle(driver); 

printf(”I0CTL_WDJ_REQUEST returned Xd\n", value); 

/* End of File */ 
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A Spy Filter Driver for NT 

Windows NT features a layered driver model, with room for very basic drivers servicing var¬ 
ious I/O controllers, as well as high-level drivers performing complex tasks. An interesting class 
of drivers is filter drivers, which are typically inserted between two levels to analyze or control 
the intermediate I/O flow. For example, you could build a filter driver for a disk drive, to moni¬ 
tor and maintain statistics for I/O requests. You could build a filter driver for a floppy drive that 
allows unlimited read access, but performs virus checks on all writes to the diskette. 

Writing Windows NT kernel-mode drivers is still kind of a black art. No matter whether 
you’re an experienced Win32 programmer, or even if you have written one or more Windows 
3.x or Windows 95 VxDs, delving into NT kernel mode is somehow like heading for the final 
frontier — nothing remains the same. It’s a completely different world with its own rules and 
traps. In this article. I’ll outline a solution to a common problem arising in low-level system 
programming: spying on the I/O traffic into and out of a black-box device. The code archive 
(see Table of Contents for availability) contains a complete sample program (ComSpy) that 
monitors the activity of any device connected to a serial RS-232 port. 



Introduction 

I’ll assume that you are at least familiar with the basic concepts of NT kernel-mode driver 
programming. To acquire some basic knowledge, I recommend peeking at the DDK documen¬ 
tation and sample files, visiting section 13 (“Win NT DDK”) of the MSWIN32 forum on 
CompuServe, subscribing to the mailing list dd k@cf n . i st.utl.pt (send “subscribe ddk” with¬ 
out the quotes to Majordomo@cfn.ist.utl.pt) and visiting http://www.ntinternals.com/. 
You won’t find all the information you need in one place; it’s like collecting the pieces of a 
huge puzzle. 

The motivation to write a serial I/O filter driver arose when I bought a digital satellite 
radio receiver, which has a serial RS-232 interface, allowing remote control via the PC. 
Unfortunately, the software for the device is written for DOS and doesn’t seem to have been 
designed with Windows NT multitasking in mind. So, I decided to roll my own Win32 con¬ 
trol program. But since the documentation of the receiver didn’t include any I/O protocol 
specifications, I was stuck. 

The way out of this dilemma was straightforward: if I only knew what the enclosed DOS 
program sent to the device, and how it reacted to certain control sequences, I would eventu¬ 
ally be able to hack the specification from scratch. Writing a filter driver would let me spy on 
everything that happened to the serial port while the PC was communicating with the satel¬ 
lite radio receiver, so that’s what I set out to build. 


“Writing Windows NT 
kernel-mode drivers 
is still kind of a black 
art. No matter 
whether you’re an 
experienced Win32 
programmer, or even 
if you have written 
one or more Windows 
3.x or Windows 95 
VxDs, delving into NT 
kernel mode is 
somehow like 
heading for the final 
frontier — nothing 
remains the same.” 


Filter Driver Basics 

Filter drivers are essentially like any other intermediate or top-level kernel-mode drivers. 
Their primary characteristics are that they are typically inserted between two layers of dri¬ 
vers, and that they communicate through three special interfaces. The first interface receives 
I/O traffic from the next higher software level. The second is the interface to the next lower 
driver. The third interface is the gate to the world above the surface of the kernel-mode 
ocean, where user-mode applications live. This last interface is needed to control the filter 
driver from user mode, and possibly to provide some neat and flashy user interface. In the 
case of a spy filter, this interface is essentially used to evaluate the data collected while 
observing the I/O traffic between the other two interfaces. 

If you’ve never written an NT kernel-mode driver before, you need to jump high before 
reaching the first step of the stairs. Users of Microsoft Visual C++ 4.2 will search in vain for 
a built-in driver wizard, or even a raw driver executable type, such as the “Application,” 
“Dynamic-Link Library,” or “Console Application” types, available from the “New Project 
Workspace” dialog. Unfortunately, none of them can be used for drivers because they need a 
completely different pile of makefile settings. 

Once again, MSDN comes to rescue — this time, with the MSDN Library CD. Search for 
the keywords “driver” and “asche,” and you’ll find a highly interesting series of articles on NT 
kernel-mode driver programming written by Ruediger R. Asche. One of them, “Wizards 
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Simplify Windows NT Kernel-Mode Driver Design,” shows how to 
build custom VC++4 wizards. And even better, it supplies a ready-to- 
use wizard for NT drivers. Although I don’t like wizards very much, I 
highly recommend using this one at least once. It will yield a makefile 
you can tailor to your needs and reuse in future projects. 

Unfortunately, there’s not enough space in this journal to print 
the full source code of the spy filter I’m presenting here, so some of 
the following discussion is a bit theoretical. You can download the 
code archive from WWW . wd j . com to get the entire picture. 

Filter Driver Structure 

To gain access to the symbols, structures, and macros necessary for 
NT kernel-mode programming, your source code must include 
ntddk.h, found in your \ddk\inc directory after you install the NT 
DDK. The main system interface is provided by ntoskrnl .exe. 
Most NT system services you are calling actually end up in this 
DLL. Note that the DDK API features lots of pseudo functions 
which are not exported by any system DLL, but instead are defined 
as macros in ntddk.h. Most of them simply manipulate some 
members of the I/O request packet or associated structures, like 
IoGetCurrentlrpStackLocationO andloGetNextlrpStackLocationO, 
which are present in almost every driver source. 

The IRP (I/O request packet) is the omnipotent system structure in 
NT kernel-mode programming. Whenever an I/O request is generated, 
an IRP is created to represent that request. Drivers receive IRPs from 
the layer above them and hand down IRPs to lower-level drivers. 
Drivers may even create IRPs on their own, for instance, if a large data 
packet must be broken into smaller pieces. It is tempting to think of the 


IRP being passed down the chain of device drivers like data being 
passed through a series of nested function calls. However, any driver in 
the chain may decide to process the IRP asynchronously, and therefore 
may return control to the next higher level driver before it has actually 
handled the request. A driver can specify an I/O completion routine 
that will get control whenever the next lower driver actually completes 
the request. So, while each driver in the chain can pass the IRP to the 
next driver, and can examine the results of that driver’s processing, IRP 
processing is not quite as simple as a set of nested function calls. 

An important part of the IRP is the I/O stack — an array of 
10_STACK_L0CATION structures at the end of the IRP structure — 
where each stack location holds data for one driver layer. This helps 
make up for the fact that the IRP has an asynchronous life of its 
own; information specific to a particular driver for a particular pack¬ 
et must reside in this stack. 

Like every NT kernel-mode driver, a filter driver has an entry rou¬ 
tine the system calls after loading the driver. This routine. 
DriverEntryt ), is the equivalent to the startup code of user-mode 
applications, although you can override this default anytime by chang¬ 
ing the build settings. It is typically placed in a separate PE file section 
named “INIT” (in uppercase letters, without leading period), so it will 
be discarded after initialization. Visual C++ users simply include a 

#pragma alloc_text (INIT, DriverEntry) 

line in their source file to throw the entry routine into the INIT section. 

DriverEntryO creates the three interfaces mentioned above and 
fills the system-supplied dispatch table with pointers to its service 
routines (see DriverEntryt ) and CreateDevices() in comspy .c, in 
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the code archive. Each interface is created with a call to 
IoCreateDeviceO. Please note that NT uses two types of device 
names. Names assigned by IoCreateDevice( ) identify the device 
in kernel-mode. If the device also needs to be visible from user 
mode (as my spy filter does), you need to create a “symbolic link,” 
sometimes also inaccurately termed “DOS device name.” Symbolic 
links are assigned by IoCreateSymbol i cL i nk (). To open a symbol¬ 
ic link from user mode, an application prepends “\\.\” to the name of 
the link. ComSpy defines a symbolic link named “WAComSpy” to 
let applications access its spy protocol data. 

At initialization time, the driver can choose which I/O requests it 
wants to service by setting (or not setting) the corresponding entries 
in the dispatch table. For instance, it may opt for servicing read and 
write requests as well as device I/O control calls. In the case of a fil¬ 
ter driver, it’s a good idea to register for all possible requests unless 
you intentionally want to avoid passing some requests down to the 
next lower driver. 

To insert a filter driver into an existing chain of drivers, NT 
offers the simple function IoAttachDevice( ). Like many other NT 
kernel API functions expecting string arguments, you must supply 
names as UNICODE_STRING structures and initialize them by calling 
the NT runtime library function Rtl Ini tUni COdeStri ng (). If 
I oAttachDevi ce () returns STATUS_SUCCESS, the filter is inserted 
into the driver chain and receives all requests originally directed to 
the next-lower driver. 

After IoAttachOevi ce( ) succeeds, the filter driver is responsi¬ 
ble for forwarding all requests to the next-lower layer. It may cut off 
the lower driver from any traffic, create and send down new requests 


of its own, or modify the data passing through in a suitable way. In 
my case, my filter driver simply analyzes and stores the incoming 
data, then passes to the next lower driver unchanged. When the 
request completes, my filter driver again analyzes and stores the 
information before passing the IRP up to the next higher driver. 

Global Driver Memory 

One important, recurring notion in NT driver programming is 
the “device extension.” This is a PV0I0 member of the 
DEV IC E_0B J ECT structure returned by IoCreateDeviceO, and is 
reserved for individual use by the driver. When you call 
IoCreateDeviceO, the DeviceExtensionSize argument specifies 
how many bytes of memory the system should allocate. Here, the 
driver may store any context information it will need later while ser¬ 
vicing I/O requests. This is a convenient means of getting global 
memory, the contents of which are persistent across all TO requests. 

comspy. h defines the structures FI LTER_CONTEXT and 
C0NTR0L_C0NTEXT as device extensions for the interfaces to the 
next-lower driver level and the user-mode world, respectively. 
FI LTER_CONTEXT simply contains a pointer to the device object of 
the next-lower driver. This pointer is used when the filter is passing 
down IRPs with IoCall Dri ver(). C0NTR0L_C0NTEXT contains the 
spy protocol buffer, as well as state information for this buffer. 
ComSpy uses the buffer in a circular fashion; if the end is reached, 
the access pointers will wrap to the beginning of the buffer. I’ve 
chosen to make this buffer fairly large (1Mb), to keep the probabili¬ 
ty of an overflow quite low. If it should overflow, the least recent 
buffer contents are discarded. 
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ComSpy features an extensive collection 
of functions for structured, formatted output 
to the protocol buffer. The main output func¬ 
tion OutO works similar to the beloved 
pri ntf ( ) function, using the percent charac¬ 
ter to insert variable arguments. However, the 
argument type specifiers are somewhat dif¬ 
ferent (see Table 1). ComSpy also features an 
universal HEX/ASCII dump facility, making 
it easy to identify patterns in the incoming 
and outgoing I/O data streams. 

Handling Requests 

The heart of the spy filter is the request 
handler, shown in Figure 1. To make it clear¬ 
er, I split my request handler into four func¬ 
tions: SpyFi 1 ter(), SpyFi 1 terBegin(), 
SpyFi 1 ter End ( ), and SpyFi 1 ter Exi t (). 
Spy Fi 1 ter( ) is called whenever the driver’s 
dispatch routine receives a request that is 
intended for the ComSpy filter device. 
Basically, it performs three tasks: it calls 
SpyFi 1 terBegi n(), sets up an I/O comple¬ 
tion routine named SpyFilterExitO, and 
passes the request down to the next-lower 
level using IoCall Driver! ). 

SpyFi 1 terBegi n( ) is responsible for 
dumping the incoming data into the protocol 
buffer. It reads various members of the I/O 
request packet (IRP) and I/O stack, and saves 
the identified data. Fetching the data returned 
by the lower driver is not that simple. Of 
course, the request handler can wait for 
local 1 Dri ver () to return, but in general, the 
original IRP won’t be accessible anymore. 
To take a snapshot of the IRP and I/O stack 
right after completion by the lower driver, the 
filter driver must set up an I/O completion 
routine; the kernel will arrange to call that 
routine after the next lower driver completes 
the request. Therefore, SpyFi 1 ter( ) calls 
I oSetCompl eti onRouti ne( ), specifying 
SpyFi 1 ter Exi t ( ) as its completion routine. 

SpyFilterExitO is simple. The hard 
work is done by SpyFi 1 terEnd( ), which 
closely resembles SpyFi 1 terBegi n() and 
writes the data returned from the next- 
lower level to the protocol buffer. The main 
purpose of SpyFilterExitO is handling 
requests that return a “pending” status, sig- 


Table 1: Format-control 
specifiers for Out() 


Xa ANSI string 

Xw Wide-character (UNICODE) string 

Xc Character 

Xu Unsigned decimal number 

Xs Signed decimal number 

Xh Hexadecimal number 

X! Ignore argument 

XX Percent character 


nifying that the request was initiated but 
not yet completed. This is typically the case 
with requests that trigger some remote 
operation, or lengthy operations which 
have been flagged as asynchronous or over¬ 
lapped. If the filter’s I/O completion routine 
receives a pending IRP, it’s not a good idea 
to call SpyFi 1 terEndt ), because it would 
write garbage to the protocol or maybe 
cause an access violation by trying to read 
invalid data. Instead, SpyFilterExitO 
simply marks the IRP as pending and 
returns without any further processing. 


I/O Buffers 

When designing SpyFi 1 terBegin () and 
SpyFi 1 terEndt ), my main intention was to 
provide a general framework for spy filters 
for various devices. This is not a trivial task. 
Windows NT supports several I/O transfer 
modes, and each mode uses different IRP 
and I/O stack members to transport I/O data. 
Essentially, there are three transfer types: 
buffered, unbuffered, and direct. Buffered 
I/O is the recommended standard method for 
slow devices and small amounts of data. In 
this case, user data is copied to a system 
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buffer that is supplied to the driver receiving the request. When the 
request completes, the reply data is copied to the very same system 
buffer, and finally copied to a user-supplied reply buffer. 

For fast I/O transfers (e.g., DMA) and large amounts of data, the 
DDK recommends direct I/O. Sometimes, neither buffered nor 
direct I/O is applicable. In this case, the driver can use unbuffered 
I/O, where the driver receives the original user buffer pointers. For 
instance, the Windows NT NetWare redirector nwrdr.sys uses 
unbuffered I/O for many file system control requests, such as 


Figure 1: The filter device handler 


#define IRP_I0(x) (pirpThls->Parameters.DeviceloControl.x) 

i/define IRP_READ(x) (pirpThis->Parameters.Read.x) 

(/define IRP_WRITE(x) (pirpThis->Parameters.Write.x) 
i/define IRP_FILE(x) (pIrpTh1s->F1Ie0bject->FileName.x) 
ifdefine IoGetMethodCodeFromCtlCode(x) ((x) l 0x00000003) 

// . . . 

NTSTATUS SpyFi 1 terBegin (PDEVICEJBJECT pDeviceObject. 

PIRP plrp, 

PV0ID pContext) 

( 

PC0NTR0L_C0NTEXT pControl Context; 

PI0_$TACK_L0CATI0N plrpThis; 

PV0ID plnput; 

DWORD dlnput, dFunction, dSubFunctlon; 

DWORD dloCode, dloMethod, dloFunctlon; 

PSTR psFunction, psSubFunction, psIoFunction: 

PSTR psIoMethod; 

pControlContext - pControlDevice->DeviceExtension; 

plrpThis - IoGetCurrentlrpStackLocation (plrp); 

dFunction - pirpThis->MajorFunction; 

dSubFunctlon - plrpThis-SMinorFunction; 

GetFunctionName (dFunction, dSubFunction, 

SpsFunction, &psSubFunction); 

Out (pControlContext, "\nFunction: Mu", dFunction); 

if (psFunction !- NULL) 

{ 

Out (pControlContext, " - Ha”, psFunction); 

} 

Out (pControlContext, "\nSubfunction:X4u", dSubFunction); 
if (psSubFunction !- NULL) 
t 

Out (pControlContext, " - Ha", psSubFunction); 

} 

Out (pControlContext, "\n”); 

plnput - NULL; 
psIoMethod - NULL; 

switch (dFunction) 

{ 

case IRP_MJ_CREATE: 

if (IRP.FILE (Length)) 
f 

Out (pControlContext, 

"\n Open/create file object \”Xw\"\n", 
IRP_FILE (Buffer)); 

) 

else 

1 

Out (pControlContext, 

"\n Open device objectin''); 

} 

break; 

case IRP_MJ_WRITE: 

psIoMethod - " Unknown"; 
dlnput - IRPJRITE (Length); 
dloMethod - pFilterDevice->Flags & 

(DO_8UFFERED_IO | DO_DIRECT_I0); 

switch (dloMethod) 

t 

case D0_BUFFERED_I0; 

plnput - pIrp->AssociatedIrp.SystemBuffer; 
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Figure 1: continued 


psIoMethod - " Buffered"; 
break; 

case DOJEITHERJO: 

plnput - plrp-MJserBuffer; 
psIoMethod - "Unbuffered"; 
break; 

case D0_DIRECT_I0: 

psIoMethod - "Direct Out"; 
break; 

} 

break; 

case IRP_MJ_DEVICE_CONTROL: 

case IRP_MJ_INTERNAL_DEVICE^CONTROL: 

case IRP_MJ_FILE_SYSTEM_CONTROL: 

psIoMethod - " Unknown"; 

dlnput - IRP_I0 (InputBufferLength); 

dloCode - IRP_I0 (IoControlCode); 

dloFunction - IoGetFunctionCodeFromCtlCode (dloCode); 

dloMethod - IoGetMethodCodeFromCtlCode (dloCode); 

switch (dloMethod) 

{ 

case METHODJUFFERED; 

plnput - pIrp->AssociatedIrp.SystemBuffer; 

psIoMethod - " Buffered"; 

break; 

case METHOD_NEITHER: 
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plnput - IRPJO (Type3InputBuffer); 

psIoMethod - "Unbuffered"; 

break; 

case METHODJNJIRECT: 

psIoMethod - " Direct In"; 
break; 

case METH0D_0UT_DIRECT: 

psIoMethod “ "Direct Out"; 
break; 

} 

Out (pControlContext, 

"\n I/O control code; 0x%08h", 
dloCode); 

Out (pControlContext, 

"\n I/O function code; 0xJS03h", 

dloFunction); 

GetloFunctionName (dloFunction, &psIoFunction); 
if (psIoFunction !- NULL) 

( 

Out (pControlContext, " — %a", psIoFunction); 

} 

Out (pControlContext, "\n"); 
break; 

) 

if (psIoMethod !- NULL) 

{ 

Out (pControlContext, 

"\n I/O transfer type; Jia", 

psIoMethod); 

Out (pControlContext, 

"\n Input buffer size: %10u\n", 

dlnput); 

if ((plnput !- NULL) M dlnput) 

{ 

Out (pControlContext, 

" Input buffer base; 0x%08h\n", 
plnput); 

Dump (pControlContext, "\n", plnput, dlnput, 0); 

) 

} 

return STATUSJUCCESS; 

} 

// . 

NTSTATUS SpyFi1terEnd (PDEVICE_0BJECT pDeviceObject, 

PIRP plrp, 

PVOID pContext) 

{ 

PC0NTR0L_C0NTEXT pControlContext; 

PIO_STACK_LOCATION plrpThis; 

PVOID pOutput; 

DWORD dOutput, dReturned, dFunction, dSubFunction; 

DWORD dloCode, dloMethod; 

PSTR psIoMethod; 

pControlContext - pControlDevice->DeviceExtension; 

plrpThis - IoGetCurrentlrpStackLocation (plrp); 

dFunction - pIrpThis->MajorFunction; 

dSubFunction - pIrpThis->MinorFunction; 

pOutput - NULL; 
psIoMethod - NULL; 

switch (dFunction) 

{ 

case IRP_MJ_READ: 

psIoMethod - " Unknown"; 
dOutput - IRP_READ (Length); 
dloMethod - pFilterDevice->Flags & 

(DOJUFFEREDJO | DO_DIRECT_IO); 
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NetWare Core Protocol (NCP) transactions. Note that this method is 
applicable only if it is guaranteed that these pointers are valid when¬ 
ever the driver tries to access them; the driver must be executing in 
the context of the calling thread. This is true for top-level drivers, 
but not necessarily for intermediate and low-level drivers. 

To find the right I/O buffer at the right time, ComSpy must iden¬ 
tify the request type as well as the transfer type. If it is an 
IRP_MJ_READ or I RP_MJ_WRITE request, the transfer type is stored in 
the Flags member of the DEVICE_0BJECT received by the dispatch 
routine. To retrieve the request, the flags should be ORed with 
D0_BUFFERED_I0 and D0_DIRECT_10, defined in ntddk.h. If 
buffered I/O is used, the system buffer pointer is stored in the 
Associatedlrp.SystemBuffer member of the incoming request’s 
IRP structure. With unbuffered I/O, the address of the user’s I/O 
buffer is supplied in the IRP’s UserBuffer member. Crazy, isn’t it? 

Similar rules apply to device I/O control and file system control 
requests (major function codes I RP_MJ_DEVICE_C0NTR0L, 
IRP_MJJNTERNAL_DEVICE_CONTROL, and IRP_MJ_FILE_SYSTEM_CONTROL). 
The only exception is that instead of the user’s input data being sup¬ 
plied in the common part of the IRP structure, it is supplied in the I/O 
stack. The I/O stack is a structure associated with the IRP that holds 
data specific to the individual levels of the driver chain. The input buffer 
is stored in the Parameters .Devi celoControl .Type3InputBuffer 
member of the current I/O stack location. 

Direct I/O differs completely from buffered and unbuffered I/O. 
Since it’s not quite trivial to catch and analyze the data transferred 
by this method, ComSpy does not spy on direct I/O. 


Figure 1: continued 


switch (dloMethod) 

{ 

case D0_BUFFERED_I0: 

pOutput - pIrp->AssociatedIrp.SystemBuffer; 

psIoMethod - " Buffered"; 

break; 

case D0JEITHERJ0: 

pOutput - plrp-MJserBuffer; 
psIoMethod - "Unbuffered"; 
break; 

case D0JJIRECTJ0: 

psIoMethod - "Direct Out"; 
break; 

1 

break; 

case IRP_MJ_DEVICE_C0NTR0L: 

case IRP_MJ_INTERNAL_DEVICE_C0NTR0L: 

case IRP_HJ_FILE_SYSTEM_CONTROL; 

psIoMethod - " Unknown"; 

dOutput - IRP_I0 (OutputBufferLength); 

dloCode - IRPJO (IoControlCode); 

dloMethod - IoGetMethodCodeFromCtlCode (dloCode); 

switch (dloMethod) 

1 

case METHODJUFFERED: 

pOutput - pIrp->AssociatedIrp.SystemBuffer; 

psIoMethod - " Buffered"; 

break; 
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Helper Applications 

ComSpy has two companion programs: DevLoad and ComSpyUI. 
DevLoad is a command-line driven, general-purpose device driver 
loader. It uses the NT service control manager to load and unload ker¬ 
nel-mode drivers on the fly. When the service control manager loads a 
driver, it takes care of all initialization steps, including registration of 
the driver in the system registry. To load the ComSpy driver, you sim¬ 
ply enter the following command at the console prompt: 


DevLoad ComSpy ComSpy.sys 

Unlike the INSTDRV sample from the Microsoft DDK, DevLoad 
also accepts relative paths to the .sys file. To include this facility, 
DevLoad uses GetFul 1 PathName() to convert a relative path to its 
fully qualified form. To unload comspy. sys from memory, just type: 

DevLoad ComSpy /unload 


Figure 1: continued 


case METHODJEITHER: 

pOutput - plrp-MJserBuffer; 
psIoMethod - "Unbuffered"; 
break; 

case METHOD_IN_DIRECT; 

psIoMethod - " Direct In"; 
break; 

case METH0D_0UT_DIRECT: 

psIoMethod - "Direct Out"; 
break; 

1 

break; 

1 

if (psIoMethod !- NULL) 

{ 

dReturned - pIrp->IoStatus.Information; 

Out (pControlContext, 

"\n I/O transfer type; U", 
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psIoMethod); 

Out (pControlContext, 

"\n Output buffer size: S=10u", 

dOutput); 

Out (pControlContext, 

"\n Output packet size; %10u\n", 

dReturned); 

if ((pOutput != NULL) U dOutput) 

{ 

Out (pControlContext, 

" Output buffer base; 0xM8h\n", 
pOutput); 

Dump (pControlContext, "\n", pOutput, dReturned, 0); 



Out (pControlContext, 

"\nRequest status - 0xSS08h" 
"\nRequest info - %10u\n", 
pIrp->IoStatu$.Status, 
pirp->IoStatus.Information); 

return STATUS.SUCCESS; 

} 


NTSTATUS SpyFilterExit (PDEVICE_OBJECT pDeviceObject, 
PIRP plrp, 

PVOID pContext) 

{ 

if (pIrp->PendingReturned) 

{ 

IoMarklrpPending (plrp); 

1 

else 

{ 

SpyFi1terEnd (pDeviceObject, plrp, pContext); 
1 

return pirp->1oStatus.Status; 

1 


NTSTATUS SpyFilter (PDEVICEJBJECT pDeviceObject, 

PIRP plrp, 

PVOID pContext) 

{ 

PFILTER_CONTEXT pFi 1 terContext; 

PI0_STACK_L0CATION plrpThis, plrpNext; 

pFi1terContext - pDeviceObject-XDeviceExtension; 

plrpThis - IoGetCurrentlrpStackLocation (plrp); 

plrpNext - IoGetNextlrpStackLocation (plrp); 

SpyFi1terBegin (pDeviceObject, plrp, pContext); 

*plrpNext - *plrpThis; 

IoSetCompletionRoutine (plrp, 

SpyFilterExit, 

pContext, 

TRUE, 

TRUE, 

TRUE); 

return IoCallDriver (pFilterContext-SpTargetDevice, plrp); 

} 

// End of File 
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Another helper application, ComSpyUI, puts a simple user inter¬ 
face on the filter driver, allowing retrieval of the spy protocol. To 
communicate with the ComSpy filter driver, ComSpyUI uses pri¬ 
vate device I/O control calls defined in comspy. h. It polls the proto¬ 
col buffer continuously, writing any arriving data to the console 
screen. Figure 2 shows some sample spy output. 

Four I/O requests are available: I0CTL_INF0 reads information 
about the filter driver (version, date, author, etc.); IOCTL_RESET clears 
the spy’s protocol buffer, discarding any pending contents; 
IOCTL_READ loads chunks of data from the protocol buffer; and 
IOCTL_WRITE inserts text to the protocol buffer. This private I/O inter¬ 
face is accessed by means of the “control device” created by ComSpy, 
accessible from user-mode through the symbolic link “VAComSpy” 
(internally named “\Device\ComSpyC”). In comspy.C, these requests 
are handled by the SpyControl () routine (not printed here). 

Porting to Other Devices 

When designing ComSpy, I tried to avoid device dependencies 
wherever possible. To make porting the code to other devices as 
simple as possible, I’ve cut all device-dependent definitions and 
code into a separate include file, comspy.dev (Listing 1). In fact, I 
was able to successfully transform ComSpy into a NetWare redirec¬ 
tor spy by simply editing comspy.dev. That’s quite remarkable, 
since the serial port and the NetWare file system are completely dif¬ 
ferent device types. 

comspy.dev defines the name of the device to be spied on 
(“\Device\SerialO” for COM1), the internal name of the filter device 
(“\Device\ComSpyF”), the internal name of the control device inter¬ 


facing to user mode (“\Device\ComSpyC”), and the symbolic link 
associated to the control device (“YDosDevices\ComSpy”). Since 
the NT kernel uses Unicode characters throughout, all device name 
defines are prefixed with an “L”. Additionally, comspy.dev speci¬ 
fies the target device type (FILE_DEV I CE_SERIAL_P0RT ) and imple¬ 
ments the routine GetloFunctionName( ), which is called by 
SpyF i 1 terBegi n( ) to identify device I/O control and file system 
control functions in the spy protocol by name. If the control func¬ 
tions names are unknown, GetloFunctionName( ) should always 
return NULL. 
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Listing 1: comspy.dev — continued 


// —...—- - -— -—----- 

// INFORMATION ROUTINES 

// — -- ——————---——- 

void GetIoFunctionName (DWORD dloFunction, 

PSTR *ppsIoFunction) 

{ 

*ppsIoFuncti on - NULL; 

switch (dloFunction) 

{ 

case I OCT L_S E RIA L_S ET_BAUD_RAT E: 

*ppsIoFunction - "Set Baud Rate"; 
break; 

case IOCTL_SERIAL_SET_QUEUE_SIZE: 
*ppsIoFunction - "Set Queue Size"; 
break; 

case IOCTL_SERIAL_SET_LINE_C0NTROL: 

*ppsIoFunction - "Set Line Control"; 
break; 

case IOCTL_SERIAL_SET_BREAK_ON: 

*ppsIoFunction - "Set Break ON"; 
break; 

case IOCTL_SERIAL_SET_BREAK_OFF: 

*ppsIoFunction - "Set Break OFF"; 
break; 

case IOCTL_SERIAL_IMMEDIATE_CHAR: 

*ppsIoFunction - "Immediate Character"; 
break; 

case IOCTL_SERIAL_SET_TIMEOUTS: 

*ppsIoFunction - "Set Timeouts"; 
break; 

case IOCTL_SERIAL_GET_TIMEOUTS: 

*ppsIoFunction - "Get Timeouts"; 
break; 

case IOCTL_SERIAL_SET_DTR: 

*ppsIoFunction - "Set DTR"; 
break; 

case IOCTL_SERIAL_CLR_DTR: 

*ppsIoFunction - "Clear DTR"; 
break; 

case IOCTL_SERIAL_RESET_DEVICE: 

*ppsIoFunction - "Reset Device"; 
break; 

1 

case IOCTL_SERIAL_SET_RTS: 

*ppsIoFunction - "Set RTS"; 
break; 

case IOCTL_SERIAL_CLR_RTS: 

*ppsIoFunction - "Clear RTS"; 
break; 

case IOCTL_SERIAL_SET_XOFF: 

*ppsIoFunction - "Set XOFF"; 
break; 

5 

case IOCTL_SERIAL_SET_XON: 

*ppsIoFunction - "Set XON"; 
break; 

case IOCTL_SERIAL_GET_WAIT_MASK: 

*ppsIoFunction - "Get Wait Mask"; 
break; 

case I OCTL_SERIAL_SET_WAIT_MASK: 

*ppsIoFunction - "Set Wait Mask"; 
break; 

case IOCTL_SERIAL_WAIT_ON_MASK: 

*ppsIoFunction - "Wait On Mask"; 
break; 

case IOCTL_SERIAL_PURGE: 

*ppsIoFunction - "Purge"; 
break; 

case IOCTL_SERIAL_GET_BAUD_RATE: 

*ppsIoFunction - "Get Baud Rate"; 
break; 

case IOCTL_SERIAL_GET_LINE_CONTROL: 


*ppsIoFunction - "Get Line Control"; 
break; 

case IOCTL_SERIAL_GET_CHARS: 

*ppsIoFunction - "Get Characters"; 
break; 

case IOCTL_SERIAL_SET_CHARS: 

*ppsIoFunction - "Set Characters"; 
break; 

case IOCTL_SERIAL_GET_HANDFLOW: 

*ppsIoFunction - "Get Flow Control"; 
break; 

case IOCTL_SERIAL_SET_HANDFLOW: 

*ppsIoFunction - "Set Flow Control"; 
break; 

case I OCT L_S E RIA L_G ET_M0 D EM STATU S: 

*ppsIoFunction - "Get Modem Status"; 
break; 

case IOCTL_SERIAL_GET_COMMSTATUS: 

*ppsIoFunction - "Get Communication Status"; 
break; 

case IOCTL_SERIAL_XOFF_COUNTER: 

*ppsIoFunction - "XOFF Counter"; 
break; 

case IOCTL_SERIAL_GET_PROPERTIES: 

*ppsIoFunction - "Get Properties"; 
break; 

case IOCTL_SERIAL_GET_DTRRTS: 

*ppsIoFunction - "Get DTR/RTS"; 
break; 

} 

} 

// - ——— --- 

// END OF FILE 

// —- - --- - 







ujryuspooa 
sjjjcI Window* 


am me 


DOS, Extended DOS, Win16, Win32, WinG, Win95, DirectDraw! Portable graphics code means your 
game can support more platforms at a lower development cost. Callus—we're the graphics experts! 

Ted Gruber Software 

P.O. Box 13408 (702) 735-1980 (voice) 

Las Vegas, NV 89112 (702) 735-4603 (fax) 

email:Fastgraph@aoi.com http://www.fastgraph.com 

Order from The Coriolis Group: 1-800-410-0192 
Fastgraph/DOS:$249 Fastgraph/Windows: $249 

Call for information about upgrades, other products, and package discounts 


l Ted Gruber 


!sof tware 


□ Request Reader Service #122 □ 


• windows developer’s journal • www.wdj.com • 


February 1997 


27 












































Finally, one shortcoming of the spy fil¬ 
ter presented here should not be neglected: 
it is not able to catch the results of requests 
that use delayed completion. When the dri¬ 
ver below ComSpy wants to complete the 
request some time later, and therefore 
returns immediately with STATUS_PENDING, 
ComSpy’s I/O completion routine will see 
only the pending status. It will not be noti¬ 
fied again when the request is eventually 
completed because ComSpy reuses the IRP 
it receives from above. Thus, it may happen 
that you will see read or status query 


requests in the protocol that do not include 
any information on what and how much 
data has been returned. To implement this 
facility, ComSpy should create its own 
IRPs, which it could control much more 
effectively. The topic is broad enough for 
an article of its own. 

Summary 

It’s not easy to begin writing Windows 
NT kernel-mode drivers. Filter drivers, 
which are able to control I/O traffic 
between two driver layers, are a special cat¬ 
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egory of NT kernel-mode drivers. They 
receive much attention in online discussion 
groups and mailing lists because they are 
quite powerful constructs. Documentation 
on how to write filter drivers is essentially 
nonexistent. That’s why companies such as 
Open Systems Resources (OSR), specializ¬ 
ing in NT driver development tools, can sell 
their “Filter Driver Development Kit” 
(FDDK) for $47,500.00 (visit 
www.osr.cotn/ for details and some free 
sample software). 

This article has outlined the basic steps 
of writing kernel-mode drivers in general, 
with filter drivers as a special case. The 
ComSpy sample, excerpts of which are 
published here, attaches itself to the 
“\Device\SerialO” driver that controls the 
serial COM1 port. It catches I/O data pass¬ 
ing up and down between applications and 
devices connected to COM1, allowing you 
to get an extensive protocol of what’s hap¬ 
pening. The most prominent approach of 
this sample driver — besides trying to 
emphasize the “how-to” of kernel-mode 
programming — is to be portable, so I hope 
you will be able to tailor this framework to 
your own needs. □ 

[Download the code from 

www. wdj.com/source.htm.] 


Figure 2: Sample spy output 


F:\MSDEV\Projects\ComSpy\Release>ComSpyUI 

Opening the spy device ... OK 

// Serial Communication Spy VI.00 
// 11-10-1996 Sven B. Schreiber 
// 100557.177@coropuserve.com 

Hit Esc to quit this program 

Hit Enter to clear the protocol buffer 

Hit any key to start ... 

-- [BEGIN] . 

Function: 0 - Create 

Subfunction: 0 

Open device object 

Request status - 0x00000000 
Request info - 0 


Function: 14 - Device Control 

Subfunction: 0 


I/O control code: 
I/O function code: 

I/O transfer type: 
Input buffer size: 

I/O transfer type: 
Output buffer size: 
Output packet size: 


0x001B0034 
OxOOD - Clear RTS 

Buffered 

0 

Buffered 

0 

0 


Request status - 0x00000000 
Request info - 0 
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Internet VBXs/OCXs 



Let PowerTCP™ bring proven TCP, Telnet/VT220, 
FTP, POP3, SMTP, UDP, TFTP and SNMP 
components (OCX/VBX/VCL/DLL/Class Libraries) 
to your next project! With numerous samples 
and expert technical support, results 
happen fast! NO ROYALTIES. 

Get a trial toolkit from our web site today! 

http://www.dart.com 


email: info@dart.com 
Ph: (315)431-1024 
Fax: (315)431-1025 


~DAR T 

COMMUNICATIONS 


AutoCAD DWG Viewer VBX, ActiveX 



Academus AS 

Olaf Helsets vei 6 
Box 70, Bogerud 
N-0621 OSLO, NORWAY 


AcademusView ActiveX Views 
AutoCAD DWG files fast and easy. 
Now includes support for R13 line- 
types, solids, fonts, attribs x-refs and 
much more. Only $199 (no royalties). 
AcademusView VBX/ActiveX PRO 
version offers functionality such as 
full zoom, pan, print, clip. Just 
$490/$1900 (no royalties). 

Phn: +47 22 62 73 90 
Fax + 47 22 62 74 92 
E-mail: academus@academus.no 
Web: http://www.academus.no/ 
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VT Protect... The New Standard for Software Licensing & Piracy Protection 



PROTECT 


by Viatech Inc. 


Attention 
Dongle Users.. 
Get Kid of 
Them!! 


The New Standard 
for Software Protection 

• Strict security that stops software piracy 

• Network independent operation 


VT Protect is a secure and reliable 
solution for protecting your software 
products from piracy. VT Protect is a 
software solution that can be easily 
imbedded within your product to 
provide various levels of controlled 
licensed use of your product. 

After all, you didn't spend all that time, 
money and energy creating a product for 
other people to share, try out or steal. 

When VT Protect is bundled with your 
software, your product is safe from 
unauthorized use. 

VT Protect licensing API's enable you to 
customize your level of license control 
and production use. 

With VT Protect, you can rest assured 
that you won't be releasing a product 
that's unprotected or under sub-standard 
protection. 


You now have a better, less 
expensive licensing solution 
without the need for hardware. 



Decryption |-, 

IS Hardware ID 5161626 233822013 1 ENCODE j 

T Pawword | DECODE ] 

• I..I 

PROTECT |. «T .] 

Panword _ 

| MT3A.13e45r62T10q91Y69a189021357635488 
Copyright*!996. Viatech. Inc Al Right* Re.erved 30001 2/25 


Get VT Protect or your 
software is up for grabs... 
(Piracy will never be the same!) 


• License duration control 

• Full product and sub-product licensing 

• License Administration tool with 
automatic license data logging and 
tracking 

• Supported on all Windows platforms 
(3.1, 95 and NT) 

• Supported on a number of Windows 
development environments (MS VC++, 
MS Visual Basic, ...and more underway) 

And VT Protect is a fraction of 
the cost of other hardware and 
software licensing solutions! 


As seen at Software Alliance '96, 
Unix Expo Plus and SD East '96 



Visit our Web site at: 

www.viatech-inc.com 


PR-WIN-BAS: Price $699 

{includes: License Admin Tool, GetID tool and your first 50 license keys.) 
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Visual Basic Tool Showcase 


Springer Does Windows 


CONCEPTS or 

OBIECT-ORIENTED 
PROGRAMMING 
with VISUAL BASIC 



STKVtN ROMAN 


Steven Roman 

Concepts of Object-Oriented 
Programming with Visual Basic 

This book has two separate goals: to 
describe the general concepts of object- 
orientation, and to explain how to do 
object-oriented programming in Visual 
Basic. Readers are assumed to have a 


familiarity with Visual Basic and a rudimentary knowledge 
of programming. Roman introduces the abstract concepts of 
object orientation, such as class, abstraction, and encapsula¬ 
tion, and then shows how to implement them. His style is 
hands-on, with plenty of code and error-handling discussed. 
1997/188 PAGES/SOFTCOVER/$29.95/ISBN 0-387-94889-9 


ESSENTIAL 

VfSliHL 

BASIC 4.0 
Jnfit 


John Cowell 

Essentials of Visual Basic 4.0 Fast 

How lo Develop Applications in Visual Basic 

This book was written to help readers get 
up and running on VB4 fast. It focuses 
on the basics instead of the minor details, 
and also reviews VB4’s advantages over 
the earlier VB3 version. With this book, 
readers can create programs with the 
same professional quality as the best programs on the market. 
1996/186 PAGES/SOFTCOVER/$24.95/ISBN 3-540-19998-5 


John Cowell and Andy Crouch 



Essential Delphi 2.0 Fast 

How to Develop Applications in Delphi 


This book provides a tour of the Delphi 
software development environment. It 
takes readers through the Pascal language 
and shows how to use the various tools 
to program. Database-specific tools 
included with Delphi are also described, 
and a “how to use” section explores the Borland database 
engine and other database formats (such as Microsoft’s 
Access). 

1996/APPROX. 200 PAGES/SOFTCOVF.R/$26.95/ISBN 3-540-76026-1 

To Order 

Visit: Fine bookstores near you. 

Call: 1-800-SPRINGER 
e-mail: orders@springer-ny.com 



Springer 


2/96 Ref. #S954 


FREE HTML/HELP AUTHORING TOOLS CD-ROM 


Call now to receive a free CD-ROM loaded with web clipart, 
WinHelp 95 Contents File Editor ($69 value), and a demo of 
our stand-alone WYSIWYG Help Magician Pro 95 software 
that allows you to create Windows help files and web pages. 

800 - 542-2742 

Software Interphase, Inc. 

82 Cucumber Hill Road 
Foster, Rl 02825-1212 
Tech: (401) 397-2340 
Fax: (401)397-6814 
email: sinterphas@aol.com 

www.sinterphase.com 



Visit 

Windows 


DEVELOPER S JOURNAL 


The Magazine for Windows Programmers 

http://www.wdj.com 


Btrieve Database Access 

Fasti 

Smithware 


These Things Arc Fast 


Get blinding performance and native access to 
Btrieve databases without writing code! Our 
advanced data binding technology outper¬ 
forms the VB Data Control, other data bound 
controls, ODBC, Jet and other access methods. 


Control Freaks Pay Attention 


Smithware ActiveX Controls give you total control over your data with these 
features: seamless integration of Btrieve’s client/server extended operations, 
extended joined record sets, bound controls and joined tables across multiple 
forms in VB (try that trick with a VB data control), advanced debugging and 
more! Build a complete data browser without writing code just by dropping 
a text box, list box, and scroll bar on a form and setting a few properties! 


Activate Your Favorite Development Environment 



za^sTjTS : 

Controls for Btrieve 



Use our ActiveX Controls in VB, Delphi, Visual C++, Internet Explorer or 
any environment that supports the ActiveX standard. Smithware ActiveX 
Controls let you build true client/server applications and can even enable 
your Btrieve based application over the web. 

Includes DDF Builder, the #1 Btrieve 
data definition tool used by Btrieve 
developers world wide. Access _, . "- 1 f 

your Btrieve data fast StnithWOfO^ IffC* 

and easy today! Power Tools For Btrieve 



2416 Hillsboro Rood, Suite 201, Nashville, TN 37212 
Phone: 615-386-3100 or 800-837-6317 
E-mail: info @ smithware.com http:/ / www.smithware.com 
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Dino Esposito 


Plug-and-Play Programming 

Plug-and-Play is not just for device drivers and hardware-oriented software. Ordinary 
applications can sometimes benefit from the new messages that Plug-and-Play generates. 
This article demonstrates how to detect network drive connects/disconnects, CD-ROM door 
events, and display size changes. 

Plug-and-Play generates two messages of interest to applications: WM_DEVICECHANGE 
and WM_DISPLAYCHANGE. WM_DEVICECHANGE passes an event identifier via wParam and a 
pointer to additional data in 1 Pa ram. WM_DI SPLAYCHANGE is generated when the screen res¬ 
olution changes; its wParam specifies the new video color depth, while 1 Pa ram contains the 
new height and width of the display. I’ve written a sample application (see Figure 1) to 
demonstrate the details of using these messages. The source code for this application 
resides in pi ugpl ay. c (Listing 1), pi ugpl ay. h (Listing 2), and pi ugpl ay. rc (Listing 3). 

The WM_DEVICECHANGE Message 

In some cases, you will want your application to handle WM_DEVICECHANGE messages. 
For instance, if the user has a Plug-and-Play CD-ROM device, your application will 
receive WM_DEVICECHANGE messages to indicate when the CD-ROM door is opened or 
closed. In practice, few Windows machines have CD-ROMs that generate the appropriate 
notifications. So, while you might want to detect CD-ROM door events to provide some 
additional functionality when possible, your application can’t really rely on Plug-and- 
Play CD-ROM notifications. I’ll demonstrate how to detect CD-ROM door events (for 
machines that support them), and you can use much the same code to detect network dri¬ 
ves being connected or disconnected. 

WM_D E V ICECHANGE can notify your application of a variety of events, as shown in Table 
1. Most of them, especially the query messages, rarely reach an application. The actual 
notifications you can detect may vary across machines, depending upon the installed 
hardware. When the user removes a CD from a Plug-and-Play CD-ROM drive, Windows 
95 sends your application a WM_DEVICECHANGE message with an event code (wParam) of 
DBT_DEVICEREMOVECOMPLETE. When the user inserts a new CD in the drive, your applica¬ 
tion should get a DBT_DE V ICEARRIVAL event. 

When the user inserts a new CD into the drive, your application might want to access 
it to check the volume label, for example. To do that, you must know which drive the 
WH_DEV ICECHANGE notification is for, and that requires decoding the 1 Pa ram parameter. 
For a device arrival event (wParam equal to DBT_DEV ICEARRIVAL), 1 Pa ram points to a 
DEV_BROADCAST_VOLUME structure (Figure 2). The dbch_devi cetype field indicates 
whether the device is an OEM device, a logical volume, or a serial or parallel port. A CD- 
ROM drive is a logical volume, and the constant to check for is DBT_DEVTYP_VOLUME. 

If the notification refers to a logical volume, then the drive identifier is in dbcv_unitmask. 
This is a DWORD in which each bit denotes a drive letter: bit 0 stands for drive A, bit 1 for drive B, 
and so on. pi ugpl ay. C (Listing 1) shows you how to extract the drive letter — look in the func¬ 
tion OnDeviceChange( ). The dbcv_flags field may contain DBTF_MEDIA or DBTF_NET, which 
indicates whether the volume involved is a network drive or a removable medium. 

Detecting Network Connections 

Your program will probably not encounter many CD-ROM notifications until a larger 
percentage of users own Plug-and-Play-compatible CD-ROM drivers. More likely, your pro¬ 
gram will receive network drive notifications. You can use almost the same code to detect a 
network drive connection or disconnection as you used for CD-ROMs; the 1 Pa ram of the 
WM_DEVICECHANGE message again points to a DEV_BROADCAST_VOLUME structure. The value in 
the dbcv_f 1 ags field distinguishes the two cases. The procedure for determining which drive 
the network volume is associated with is the same, since network drives are treated as logi¬ 
cal volumes. 



“Plug-and-Play is not 
just for device drivers 
and hardware- 
oriented software. 
Ordinary applications 
can sometimes 
benefit from the new 
messages that Plug- 
and-Play generates. 
This article 
demonstrates how to 
detect network drive 
connects/disconnect, 
CD-ROM door 
events, and display 
size changes.” 


Borland C++ v5.x 
Visual C++ v4.1 


Dino Esposito is a senior software engineer in 
Rome, Italy. He is the author of many applications 
for the photography world and a contributing editor 
to many Italian programming magazines. You can 
contact him at esposito@infomedia.it. 
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THANKS TO McCABE’S TRAIL 
BLAZING CYCLOMATIC METRIC 

our testing tools today excel at 
graphics and code comprehension. 


No need for you to live on the edge by testing with unexplored methodologies. McCabe 
already did it, and in today’s competitive environment management has no patience for 
second guesses. In 1976 Tom McCabe first published his Cyclomatic Complexity Metric in 
the IEEE. In 1996 it was published by the National Institute of Science and Technology. Unlike 
other tools the widely known McCabe Visual Testing ToolSet™(VTT) verifies the interaction 
between code constructs, giving you a real leg up, and enabling a much more rigorous testing 
process. See for yourself. Call for our demo. Or write: McCabe & Associates, 5501 Twin 
Knolls Road, Ste.111, Columbia, MD 21045. Runs in Sun, Windows 95/NT, IBM, DEC, HP, 
SGI, SCO, DG environments. Also available are Quality Assurance and Reengineering 
Toolsets. 


For instant information just 
call us at: 800-638-6316, or 
visit us at www.mccabe.com 


——McCabe 
■ w is* Associates® 

Uncover Your Software 
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The WM_DISPLAYCHANGE Message 

Before Windows 95, changing the display resolution 
required you to reboot the computer, so there was no reason for 
a WM_DISPLAYCHANGE message. Now, however, Windows 95 lets 
users easily change the screen resolution without rebooting. This is 
useful when testing whether your code to adapt to different resolu¬ 
tions works correctly. By right-clicking on the desktop, users can 
invoke the property dialog for the display and change its width and 
height as easily as they can switch among tasks using Alt-Tab. 


Listing 1: plugplay.c — Sample Plug-and-Play 
application 


#include "plugplay.h" 

#include <windowsx.h> 

(/include <dbt.h> /* PnP definitions */ 

#define PRG_NAME "Plug-and-Play Demo" 

#define GET_$IZE(h) (IsDlgButtonCheckedth.IDC_640) \ 

?MAKEL0NG(640,480) \ 
:IsDlgButtonChecked(h,IDC_800) \ 
?MAKEL0NG(800,600) \ 

:MAKELONGt1024.768)) 

LRESULT CALLBACK APPJlgProc! HWND, UINT, WPARAM. LPARAM ); 
VOID OnOeviceChanget HUND, UINT, DEV BROADCASTJDR FAR* ); 
VOID OnDisplayChangel HUND ); 

WORD SetCurrentBitsPerPeK HWND ); 


#1 fdef BORLANDC 

# pragma argsused 
jjendlf 

INT APIENTRY WinMainl HINSTANCE hlnstance, HINSTANCE hPrevious, 
LPSTR 1psz, INT iCmd ) 


( 


return DialogBox! hlnstance, "DLGJiAIN”, NULL, 
(DLGPR0C)APP_D1gProc ); 


LRESULT CALLBACK APPJlgProc! HWND hDlg, UINT uiMsg. 

WPARAM wParam, LPARAM IParam ) 

{ 

switch! uiMsg ) 

{ 

case WMJNITDIAL0G: 

CheckRadioButton! hDlg, IDC_640, IDC_1024, IDC_800 ); 
break; 

case WM_DEVICECHANGE: 

OnDeviceChange! hDlg, (UINT)wParam, 

(DEV_BROADCAST_HDR FAR*)1Param ); 

break; 

case WM_DISPLAYCHANGE; 

MessageBox! hDlg, "The screen size changed.", 
PRGJAME, MB_IC0NINF0RMATI0N ); 

break; 

case WMJOMMAND: 
switch! wParam ) 

( 

case IDOK; 

OnDisplayChange! hDlg ); 
return 1; 
case IDCANCEL; 

EndDialog! hDlg, FALSE ); 
return 0; 

} 

break; 

) 

return 0; 


VOID OnDisplayChange! HWND hDlg ) 

( 

DEVMODE dm; 

DWORD dwSize - GET_SIZE(hDlg); 

ZeroMemory! Sdm, sizeof!DEVMODE) ); 

dm.dmSize - sizeof(DEVMODE); 

dm.dmPelsWidth - LOUORD(dwSize); 

dm.dmPelsHeight - HIWORD(dwSize); 

dm.dmBitsPerPel - GetCurrentBitsPerPel(hDlg); 

dm.dmFields |- DM_BITSPERPEL|DM_PELSWIDTH|OM_PELSHEIGHT; 

ChangeDisplaySettings! &dm, 0 ); 

) 



The Willows Toolkit 

A Royalty-Free Solution 

T rue cross-platform support means more than just 
Unix®. It also includes Macintosh®, JAVA®, real-time 
and embedded systems with more target environments 
on the way. Move your existing Windows™ source code 
to the target platform, recompile, relink to our libraries, 
test and that's it! You now offer native support and native 
performance of your applications on many more operat¬ 
ing systems with little incremental effort! 

Win32? Win 16? MFC? Borland OWL? No problem! 

We do it all! And we even provide the source code to our 
libraries so you are in full control! 

Oh! One last thing: are you on a budget and can't justify 
either the high price of Mainsoft or Bristol toolkits or the 
$75 to $200 royalty they levy against each copy of the 
application you develop and ship to your end-user? 

Then call us today! 

Download your free evaluation copy today! 
www.willows.com 


WILLOWS 

Willows Software, Inc. 12950 Saratoga Avenue, Suite A, Saratoga, CA 95070 
2727 Philmont Avenue, Huntingdon Valley, PA 19006 
(800) 814-6495 or (408) 777-1820 
Fax: (408) 777-1827 info@willows.com 
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If your program needs to detect changes in screen size, it 
must be able to respond to WM_D ISP LAY CHANGE messages. With 
WM_D ISPLAYCHANGE, the low and high words of 1 Pa ram denote the 
new size (width and height, respectively), while wParam is the new 
number of colors (bits per pixel). Windows 95 sends this message 
after the desktop resolution has changed. 

Changing the Display Dynamically 

Your application can change the screen resolution via a Win32 
API call. Windows 95 can dynamically switch only between screen 
configurations that have the same font size and color depth (bits 
per pixel). The functions you call to switch between resolutions 
are EnumDi spl ay Sett i ngs () and ChangeDisplaySettingsO. 
EnumDispl aySettings( ) enumerates all the display modes avail¬ 
able on your machine, each of which is represented by a DEVMODE 
structure. Despite the large number of fields in this structure, only 
five are meaningful for enumerating the display modes: 
dmBitsPerPel, dmWidthPels, dmHeightPels, dmDisplayFlags, and 
dmDisplayFrequency. Moreover, dmDi spl ayFlags and 
dmDi spl ayF requency are supported only under Windows NT. The 
following lines show how to fill a listbox with all the available 
modes: 

DEVMODE dm; 
iModeNum = 0; 

whi1e(EnumDisplaySettings( 

NULL,iModeNum++,&dm) ) 

{ 

CHAR sz[80]; 


Supports 
Windows 95 & 
Windows NT 


SERIAL I/O 


The ONLY Serial Communication Libraries, DLLs, & Tools 
You Will Ever Need For Windows 3.x, Windows 95, 
Windows NT, and MS-DOS. Accept No Less Than The Best. 


http://www.wcscnet.com/home.htm 


COMM-DRV/LIB™ 

Professional Serial I/O Libraries & DLLs for 
Windows 3.x, Windows 95, NT, & MSDOS 

_ Supports ALL languages, tools, or applications that can 
call the Windows API. 

• Complete source code to all libraries & DLLs. 

• Same API for Windows 3x. Window, 95. NT. & MS-DOS. 

• High level Hayes compatible modem functions. 

• X, Y, Zmodem file transfers on multiple ports. 
Asynchronous & timed callback to user functions on 

• different serial communication events(modcm signals, 
buffer counts, character reception, and more). 

Supports Visual C/C++, ANSI C/C++, QuickBasic, 

Visual Basic (MSDOS & Windows), Assembly, Access. 

• Transmit data from user callback on any event.. 

• Extensive scanning of input character stream. 

^ Support most tntelligent/all dumb multiport cards(Amet. AST, 
Boca, Cyclades. Digiboard. GTEK. & many more). 


COMM-DRV/VxD™ 

Ultra High Speed Serial I/O VxD For Windows 

• Windows(9S & 3.x) DLLs with API calls into the 32bit VxD. 

• MS-DOS high speed libraries for calling VxDs from a DOS box. 

• All serial communication interrupts at ring 0 in 32 bit mode. 

• Uses transmit & receive F!FOs( 16450,16550, 16650, etc.). 

• Win32, Win 16. Console, & MS-DOS apps active concurrently. 

• Over400K baud under Windows 95 & Windows 3.x!!! 

• Integrates seamlessly with all COMM-DRV products. 

• Compatible with Visual C/C+-, Visual Basic and many more tools 


Features Supported By All Products 

• Rcmap'C'hange baud rates/divisor. 

• Product Customization. 

• Hardware/Software Flow Control. 

• Unlimited number of ports active concurrently, 

• 8250/16450/16550 Auto detection/Up to 400 KBaud. 

• 100% Port re-entrant codedmportant for multitasking). 

• Support all standard dumb multiport cards. 


COMM-DRV/DOS™ 

MS-DOS Serial I/O TSRs & Utilities 

.True DOS device driver that allows serial ports to be opened 
[ J like files under MS-DOS & Windows. 

-FOSSIL interface for all supportcd(Supports all BBS. Mailers, 
r ctc.[PCBoard, Wildcat, Frontdoor, Doorway, Renegade, etc.]) 
[•Provides Intl4h, lnt2lh, & DAM interfaces. 

•Compatible with Desqview and Windows. 

[•Real time serial port monitoring to screen and disk. 
•Mini-BBS for file transfer Spa wnable file transfer engine. 
[•Supports most intelligent & non-inlelligent multiport cards. 


WCSC Price List 

COMM-DRV/Lib(DOS,Win3x,Win95,NT)...$189.95 
COMM-DRV/Lib(Competitive Upgrade)..$ 99.95 

COMM-DRV/VxD.$189.95 

COMM-DRV/Doa.$ 99.95 

4Port Card(16550/8 bits).$170.00 

4Port Card(16550/16 bits).$199.95 

8Port Card(16550/16 bits).$225.00 

8Port Card(16550/16 bita/Ext.Box)..$299.95 

Professional Combo (Lib, VxD).$329.95 

Software Combo(Lib,VxD, Dos).$399.95 

Complete Combo<Sftwe+4Port(16550)..$499.95 



WCSC 


2470 S Dairy Ashford Suite 188, Houston, TX 77077 

1-800-966-4832 713-498-4832 
(Fax) 713-568-3334 (BBS) 713-568-6401 
Internet: sales@wcscnet.com 

Visa/Mastcrcard/Discover/AMEX/Checks/Approved P.O. WWW: http://www.WCSCnet.com/home.htnT 
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wsprintf(sz,"%dx%d, %d bit", 

dm.dmPelsWidth, dm.dmPelsHeight, 
dm.dmBitsPerPel); 

ListBox_AddString(hwndListbox, sz); 

} 

The first parameter to EnumDi spl aySetti ngs () is the display type and 
must be NULL under Windows 95. The second is an internal index, 
and the last is the output buffer containing the DEVMODE information. 

If you want to change the video resolution, start by initializing a 
DEVMODE variable this way: 

DEVMODE dm; 

ZeroMemory( &dm, sizeof(DEVMODE) ); 
dm.dmSize = sizeof(DEVMODE); 
dm.dmFields |- DM_BITSPERPEL 
|DM_WIDTHPELS|DM_HEIGHTPELS; 

You must specify the size of the structure along with the fields that 
you will be working with. To complete the video resolution change, 
set the new width and height in pixels. 



Listing 2: plugplay.h 

— Resource IDs for plugplay.exe 

//define WIN32 LEAN AND MEAN 


//define STRICT 
//ifndef WORKSHOPJNVOKED 
// include <windows.h> 

//endif 


//define IDC_640 1000 

//define IDC 800 1001 


//define IDCJ024 1002 

/* End of File */ 
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As I mentioned earlier, ChangeDispl aySettings () can change 
the resolution only if the font size and the color depth are still the 
same. plugplay.C (Listing 1) contains the function 
GetCurrentBi tsPerPel () that returns the bits per pixel for the current 
display mode. Changed spl aySetti ngs () wants a pointer to DEVMODE 
data with the new settings and a flag denoting how the function should 
behave. If this flag is zero, the settings should apply dynamically (if 
possible); if it is CDS_TEST, then the function verifies only whether the 
graphics mode can be set; if it is CDSJJPDATEREGISTRY, the changes 
will occur and become persistent. 

The returned value indicates what action the function performed. 
The operation may result in a success, a failure, or an intermediate 
result. An intermediate result occurs when the call is correct but the 
system needs a restart before it can display the new settings. In this 
case, the return code is DISP_CHANGE_RESTART. Note that if you pass 
in unavailable non-zero sizes for the new screen width or height, 
they will be truncated to the nearest feasible value lower than the 


Listing 3: plugplay.rc — Dialog box for sample 
applications 


; #inetude "plugplay.h" 

APPJCON ICON DISCARDABLE "PlugPlay.ico" 

DLG_MAIN DIALOGEX 0. 0, 244, 122 
f STYLE DS_M0DALFRAMEjDS_CENTER|WS_P0PUP|WS_CAPTI0N|WS_SYSMENU 
j CAPTION "Plug-and-Play Demo" 

3 FONT 8, "MS Sans Serif" 

| BEGIN 

PUSHBUTTON "Cl ose", IDCANCEL, 181.101,57.14 
| CTEXT "This dialog detects PnP events triggered CD door \ 
f open/close or network drive connect/disconnects. In addition \ 
j you may use it to dynamically set a new display size.", 
-1,6,8,232,40,WS_B0RDER,WS_EX_DLGMODALFRAME| 
WS_EX_CLIENTEDGE 

! GR0UPB0X "Display Settings",-1,7,64,160,51 

CONTROL "640 x 480 with current number of colors”,IDC_640, 
"Button".BS_AUT0RADIOBUTTON,15,75,141,13 
1 CONTROL "800 x 600 with current number of colors”,IDC_800, 
"Button",BS_AUTORADIOBUTTON,15,86,141,13 
CONTROL "1024 x 768 with current number of colors”,IDC_1024, 
"Button", BS_AUT0RADI OBUTTON ,15,97,148,13 
j PUSHBUTTON "Change Display”,IDOK,181,83,57,14 
' END 


Table 1 : WM DEVICECHANGE notification codes 

DBT QUERYCHANGEC0NF1G 

Request to dock or undock 

t DBT CONFIGCHANGECANCELED 

Request to dock or undock canceled. 

I DBT CONFIGCHANGED 

Request to dock or undock accepted. 

I DBT_DEVICEARRIVAL 

Device inserted and available. 

i DBTJEVICEQUERYREMOVE 

Request to remove a device. Can be denied. 

5 DBT DEVICEQUERYREMOVEFAILED 

Request to remove a device canceled. 

1 DBT DEVICEREMOVECOMPLETE 

Device removed. 

1 DBT DEVICEREMOVEPENDING 

Device ready to be removed. Cannot be denied. : 

1 DBT DEVICETYPESPECIFIC 

Custom device event occurred. 

I DBTJSERDEFINED 

Custom message 



This dialog detects PnP events triggered CD door 
open/dose or network drive connect/disconnects. In addition 
you may use it to dynamically set a new display size. 


Display Settings 


r 

c 


640 x 400 with current number of colors 
800 x 600 with current number of colors 
1024 x 768 with current number of colors 



Figure 1: Demonstrating Plug-and-Play messages 


new screen width or height. For example, if you specify 590 for the 
height, it is truncated to 480. If there is no such value (e.g., you 
specify the height as 450), then the function will use the minimum 
available value (again 480). 

Summary 

The Microsoft Logo specifications recommend that you design 
your applications to be aware of Plug-and-Play events. This article 
has presented two concrete examples of how to do that. As more 
hardware and software support Plug-and-Play, it will become 
imperative that your applications be aware of these notifications. □ 

[Download the code from WWW. wdj. com/ SOUrce.htm.] 


Figure 2: WM DEVICECHANGE volume structures 


typedef struct tagDEV_BR0ADCAST_HDR 
( 

UL0NG dbch_sfze; /* size of the struct */ 

UL0NG dbch_devicetype; /* OEM, PORT. VOLUME */ 

UL0NG dbch_reserved; /* not used */ 

} DEV_BR0ADCAST_HDR; 


typedef struct tagDEVJROADCASTJOLUME 
{ 


ULONG dbch_size; 

/* size of the struct 

*/ 

ULONG dbch_devicetype; 

/* VOLUME 

-*/ 

ULONG dbch_reserved; 

/* not used 

*/ 

ULONG dbcv_unitmask; 

/* drive bit mask 

*/ 

USHORT dbcv_f 1 ags; 

/* drive or media 

*/ 


} DEVJROADCASTJOLUME; 



The “Point-and-Click” Setup Builder 
for Windows 95/NT & Windows 3.1 

Imagine creating professional installs for your software in only 
minutes. You can with Setup Factory 4.0! Simply add your files, 
customize the screens you want to display and click the “Build” 
button. Your files are compressed, your setup program is created and 
then everything is output to your disk set. Sound easy? It really is! 

GREAT NEW FEATURES 
Single file setup.exe • Selective install • Builds both 16 and 32 bit 
setups • Full featured uninstall • Great for CD-ROM • Edit registry 
and system files • Wizard type interface • Install files to any location 
• Create shortcut icons and groups • Much more! 

TRY IT OUT - RISK FREE! 

You can get a fully functional evaluation version from our web site 
or our BBS at (204) 661-3044. Better yet, call us or your favorite 
software dealer to order the complete package. With its royalty-free 
license and value conscious price, you'll be saving a lot more than 
just your time! 
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Tired of Wrestling with OCX/DLLs?? 



WWW.STINGSOFT.COM 


Objective Grid 1.1 


Objective Toolkit 1.1 


Objective Plug-in 1.0 


A full featured MFC grid 
control that you can bind to 
any data source with one 
virtual function override! 
ODBC and DAO are fully 
supported. Also supports 
UNICODE, find/replace, 
print preview, undo/redo 
and features a flexible 
cell control architecture. 


A package of over 40 MFC extensions 
including sizable docking views (like 
Developer Studio), tabbed windows, 
masked edit, image classes, MDI 
alternatives (workbook and floating 
documents), calendar control, shortcut 
editor, encrypting/compressing 
CFiles, panning/zooming CViews, 
Workspace manager, thumbnailing 


Convert any MFC application 
into a Netscape plug-in. Let our 
plug-in wizard and helper 
classes do the work for you! 



'We add class to MFC!’ 


_ 1-800-924-4223 

All products feature FULL SOURCE CODE, 100% MFC compatibility, and a 30-day 1 Voice: (919) 933-0863 

money back guarantee! Bundle pricing is available. Check our web for free demos. Fax: 19 ) 933-0892 
— — ■■■■■■— Email: sales@stingsoft.com 














Please send us your best tricks and hacks - 
those clever pieces of code to make things work 
the way they should! You’ll receive at least $50 
for each tip that we print. Send your submissions to 
wdletter@mfi.com with the header ‘Tech Tip submission.” 


Creating Fonts Easily from MFC 

T. Jayaraman 

jay@imagine.globemail.com 

Development environments such as VB allow the programmer to 
create a font using the font name and size, and attributes such as 
bold, strikeout, etc. To use the font creation functions CreateFontO 
and CreateFontlndi recti ), the SDK or MFC programmer must 
know additional details, such as the font family, pitch, clip preci¬ 
sion, output precision, etc. Although these functions provide flexi¬ 
bility when creating fonts, the programmer must supply many 
details just to create a simple text font. This Tip provides a function 
that, given a font name and point size, creates a font. Optional para¬ 
meters include bold, strikeout, underline, and so on. 

Windows provides the function EnumFontFami 1 ies( ) which 
enumerates the fonts in a specified font family available on a 
given device (refer to the SDK documentation for more informa¬ 
tion). Windows calls the specified callback function with infor¬ 
mation about the available fonts for the specified font family. I 
use this information to gather default attributes for a font before 
creating it. 

The file font.C (Listing 1) contains the two functions required 
for creating fonts easily: CreateFontExt ) and 

EnumFontFamilyProcO. CreateFontExt) behaves exactly like 
CreateFontO, except that the number of inputs to the function is 
reduced. Though this function is written using C, you could write an 
MFC wrapper around the CFont class to do the same thing. The 
sample program (in font.zip, available electronically) is a modi¬ 
fied version of Generic. The only changes are those made to the 
About dialog procedure. 

Task Switch Icon for Dialog-Based App in Win 95 and NT 
4.0 

Blake Miller 

bmiller@cosmoslink.net 

In the October 1996 issue of WDJ, I noticed the SDK Annotation 
on WM_SETICON, which brought this to mind. 



Can’t find that Tech Tip from a past issue? The Windows Developer's 
Journal CD-ROM with full search capabilities is now available. 

See page 38 for more information. 


Leor Zolman teaches hands-on seminars on C/C++ programming and UNIX. 
His first book, Illustrated C, was published in 1992. Contact Leor at the 
leor@bdsoft.com, or visit the BD Software On-Site Training page at 
www.tiac.net/users/leor/bds for information about his C and C++ on-site sem¬ 
inar offerings. 



Edited by Leor Zolman 

Tech Tips 


Just yesterday I was trying to figure out why my 
apps were not showing icons in the Task Switcher (ALT- 
dows under Windows 95 and Windows NT. This is a “default” dia¬ 
log-based app generated with Visual C++ 2.2. The following mes¬ 
sage handler is not called on Windows NT 4.0 or Windows 95: 


ON_WM_QUERYDRAGICON() 


// The system calls this to obtain the 
// cursor to display while the user 
// drags the minimized window. Ha! 

// Except if you are on Windows 95 
// or Windows NT 4.0. It IS called 
// by NT 3.51 

HCURSOR MyDialog::OnQueryDrag I con() 

{ 

return( (HCURSOR) m_hIcon ); 

} 


However, when I put the following code snippet into the 
On I n i t Di a 1 og () handler, then I got both the large icon in Task 
Switcher and the small icon in the taskbar when the dialog was min¬ 
imized: 


// issue WM_SETICON in Windows 4 to get 
// icon in task switcher 
if( LOWORDtLOBYTEt::GetVersion())) >= 4 ) 
{ 

#ifndef ICON.BIG // WINUSER.H 
PostMessage(WM_SETICON, 1, 

(LPARAM)((HICON)m_hIcon)); 

#el se 

PostMessage(WM_SETICON, ICON.BIG, 

(LPARAM)((HICON)m_hIcon)); 

#endif 

} 


Note that the m_hIcon is initialized in the constructor: 

// Note that Loadlcon does not require a 
// subsequent Destroylcon in Win32 
m_hIcon = AfxGetAppO 

->LoadIcon(IDR_MAINFRAME); 

Using the Hourglass Cursor 

Petter Flesselberg 
petter.hesselberg @ ac.com 

Windows applications typically display an hourglass cursor dur¬ 
ing lengthy operations, as follows: 
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// Set hourglass cursor, saving the current one: 
const HCURSOR hcurSave = 

SetCursor(LoadCursor(0, IDC_WAIT)); 

// ...perform lengthy operation here... 

// Restore old cursor: 

SetCursor(hcurSave); 

SetCursor () returns a handle to the previous cursor; this seems 
to imply such usage. Most Windows books I’ve seen do the 
above, and the MFC class CWai tCursor encapsulates the same 
functionality. 

So, what’s wrong with this picture? Consider the following 
sequence of events: 

l.When the operation starts, the cursor is an IDC_ARR0W, a fact 
remembered by hcurSave. 


Listing 1: font.c 


/* 

File: Font.c 
Author: T Jayraman 
Date: September 18, 1996 

*/ 

jfinclude <wi ndows. h> 
ifinclude <assert.h> 
ifinclude <stri ng. h> 
iHnclude "font. h" 

j ***************^********************************** ****** j 

// Function: CreateFontEx 

// Creates a font given a name and size 
// Parameters : font name , size 


2. During the operation, the user moves the 
mouse and the hourglass cursor comes to 
rest on a split bar. 

3. The operation ends and the cursor is 
changed back to an arrow. 

The problem is that the cursor should 
not be an arrow when it’s on the split bar. 
As soon as the mouse pointer is moved, the 
cursor will display correctly, but in the 
meantime, there’s a tiny crack in the 
smooth surface of illusion we strive to cre¬ 
ate for our users. 

This particular crack can be mended 
quite easily, and the result will actually be 
simpler to use than the standard example 
above. What I need is a function analogous 
to Inval idateRectt ), except that it oper¬ 
ates on the cursor. I no longer need to save 
the existing cursor, and the above example 
becomes: 

// Set hourglass cursor: 
SetCursor(LoadCursor(0, IDC_WAIT)); 

// ...perform lengthy operation here... 

// Restore normal cursor: 
InvalidateCursorO; 

The implementation of InvalidateCursorO 
is simple: 

void InvalidateCursor ( void ) 

{ 

POINT pt; // Screen coordinates! 
6etCursorPos(&pt); 

SetCursorPostpt.x, pt.y); 

) 

This moves the cursor to its current loca¬ 
tion (i.e., the cursor does not actually 
move anywhere), forcing a WM_SETCURSOR 
message in the process. Doing it this way 
is a lot simpler than synthesizing and dis¬ 
patching a WM_S ETCURSOR message 
myself. 

Please note that GetCursorPos and 
SetCursorPos have changed somewhat 
during the migration from Winl6 to 
Win32. In Win 16, these were void func¬ 
tions; in Win32, they each return TRUE for 


Solaris 
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success and FALSE for failure. Presumably, this change is related 
to preemptive multithreading. As is its wont, however, 
Microsoft’s documentation is not very specific about possible 
causes of failure. 


waitcurs.h (Listing 2) and waitcurs.cpp (Listing 3) show a 
C++ replacement class for CWaitClirsor, including a somewhat 
more careful Win32 implementation of the InvalidateCursor 
functionality. 


Listing 1: font.c — continued 


// bool values for bold, italic 

// underline and strikeout. 

// returns font handle on success, NULL otherwise. 

/***********************************★********************* j 

HFONT CreateFontEx (LPCSTR szFontName, int nSize, 

BOOL bBold, BOOL bltalic, BOOL bUnderline, BOOL bStrikeOut) 

{ 

LOGFONT If; 

HFONT hFont - NULL; 

HDC hScreenDC; 
int nRet; 

assert (szFontName); // Invalid params ? 
assert (nSize); 

// get a device context (screen) 
hScreenDC - GetDC(NULL); 
assert (hScreenDC); 


lf.lfHeight - -MulDiv (nSize, 

GetDeviceCapsthScreenDC, LOGPIXELSY), 72) ; 

lf.lfWidth - 0; // Force Windows to use default width. 

lf.lfHeight - bBold ? 700 ; 400; // Windows values 

lf.lfltalic - bltalic; 
lf.lfUnderline - bUnderline; 
lf.lfStrikeOut - bStrikeOut; 

hFont - CreateFontlndirect (&lf); 
return hFont; 


j ********************************************************* j 

tt EnumFontFamProc - callback function 

// callback function where windows fills the value of 

// logfont structure 

// If called, return 0 to indicate that we have enough 
// information and we don't want to be called again. 

// IParam - contains pointer to LOGFONT structure to fill. 
/*********************************************************/ 


nRet - EnumFontFamilies (hScreenDC, szFontName, 
(F0NTENUMPR0C)EnumFontFamProc, &lf); 

ReleaseDC(NULL, hScreenDC); 

// if the font is invalid nRet will have value 1 else 0 
if (nRet) 

return NULL; 

// Converts point size to logical font size for MM_TEXT only! 


int CALLBACK _export EnumFontFamProc (LOGFONT* Iplf, 

NEWTEXTMETRIC* lpntm, int nFontType, LPARAM IParam) 

( 

LOGFONT *1pLogFont - (LOGFONT *)1 Pa ram; // Extra param! 
assert (1 pLogFont); 

memcpy (1pLogFont, lplf, sizeof (LOGFONT)); 
return 0; // indicate that once is enough. 

} 

// End of File 
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Tech Tips Letters 

After reading Gorkhmaz Mikailov’s tip in the August 1996 
WDJ, I have a further improvement to suggest. Rather than use a 
separator as the placeholder in your toolbar, use a button. 

Advantages 

•You can add the status bar, online help, and tool tip in the 
resource editor at the same time that you create the control's ID. 

• You can change the position of the control within the toolbar 
just by dragging it into the resource editor without changing 
the source code. 

Disadvantages 

• You waste disk space equal to one button’s bitmap. 

•You need to find the control’s position by calling 
CToolBar::CommandTolndexl ), then change it to a separator 
by calling CTool Bar: :SetButtonInfo(). 

From CFormatBar::Pos iti onCombos () in my MDI enhanced 
version of WordPad: 

int iIndex = CommandToIndexlID_FONT_NAME); 

ASSERT (ilndex != -1); 

SetButtonlnfoliIndex, 1D_F0NT_NAME, 

TBBS_SEPARATOR, rect.Width!)); 


Andrew Dalgleish 
andrewd@axonet.com.au 

In the July 1996 “Tech Tips,” the first tip regarding _huge vari¬ 
ables in VC++1.52 and written by Mike Mikailov contains incor¬ 
rect information. Huge blocks of memory may be allocated to 
>128K if — and only if — the size of individual elements is a 
power of 2, not multiple of 4 as claimed — otherwise, his third 
workaround, allocating an array of 150K+ chars, would fail. 

This third workaround is also incorrect — the allocation will suc¬ 
ceed, but some elements of the array will not be correctly accessed. 
Data corruption will occur, because some elements will straddle a 64K 
block boundary and will not be accessible by manipulating only the 
offset of the pointer (which pointers to structures — even _huge point¬ 


Listing 2: waitcurs.h — Declaration and inline imple¬ 
mentation 


II 

II Waitcurs.h 

// Declaration and Inline Implementation 
II 

class WaitCursor { 
public: 

WaitCursorO; 

—WaitCursor(); 
void Restore!): 

1 : 

II 

II Inline functions: 

// 

inline WaitCursor::WaitCursor!) 

{ 

::SetCursor(::LoadCursor(0, IDC_WAIT)): // or call Restore... 

} 

inline void WaitCursor::Restore() 

1 

:: SetCursor(::LoadCursor(0, IDC_WAIT)); 

1 

/* End of File */ 


ers to structures — do to access elements of the stmcture). Borland 
and Microsoft have both documented this huge-pointer limitation. 

The only true simple workaround to the problem is to pad the 
size of the structure to a power of 2. 

A1 Petterson 

aamp@oro.net or aamp@alumni.caltech.edu □ 
[Download the code from www. wdj. com/ source ,htm.[ 


Listing 3: waitcurs.cpp — Implementation 


II 

// WaitCurs.cpp: Implementation 
II 


(/include "WaitCursor.h" 

WaitCursor::~WaitCursor!) // Forces a WM_SETCURSOR message. 

1 

CPoint pt; // Screen coordinates! 

#1 fdef .WIN32 

if { !::GetCursorPos(&pt) ) 

TRACEO!"WaitCursor::~WaitCursor!): GetCursorPos Failed\n"): 
else if ( !::SetCursorPos(pt.x, pt.y) ) 

TRACE2!"WaitCursor::~WaitCursor(): " 

"SetCursorPos (JSd.M) Failed\n", 
pt.x, pt.y); 

(/else // Win 16 
::GetCursorPos(&pt); 

::SetCursorPos(pt.x, pt.y); 

(/endif 

} 

//End of File 
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If you discover a bug in the latest version of 
your favorite compiler, email it to us at 
wdletter@mfi.com. Please specify which ver¬ 
sion of your compiler you are using and include a tiny 
program that demonstrates the problem, along with the 
exact command-line options needed to compile it. 


Mark Nelson 

Bug++ of the Month 



October 1996 saw the arrival of a significant personal milestone 
in my career as a C++ programmer. I received copies of Microsoft’s 
Visual C++ 4.2 as well as the updated version of Borland C++ 5.0. 
What was probably just a ho-hum day for my UPS man marked a 
first for me: I now had two C++ compilers that both supported the 
same string class! 

String handling has been a controversial topic to C and C++ pro¬ 
grammers nearly from Day One. C offered only marginal intrinsic 
support for string types, and provided library functions that proved 
to be a fertile breeding ground for programmer errors. While there 
were good reasons why the designers chose not to include string 
support in C, its absence was a continual thorn in the side of those 
promoting C as a professional programming language. 

Almost from the date of its inception, C++ was armed with the 
tools to add great string support to the language. The ability to cre¬ 
ate new data types, combined with niceties such as operator over¬ 
loading, made “class string” the favorite first project of seemingly 
every C++ neophyte. 

The problem is that every compiler seemed to have a different 
version of the string class in its library, and every version had differ¬ 
ent capabilities. For programmers writing code designed to support 
multiple compilers on multiple platforms, string classes were still 
tantalizingly out of reach. 

The Bug 

All this has changed with the ANSI C++ standard, of course. 
And since Microsoft and Borland were both advertising full 
ANSI library support in their current releases, I thought it was 
time for me to dive in. 

One of the utility programs I’ve used over the years counts the 
appearances of tokens in text files. The addition of the Standard 
Template Library (STL) and the string class to my C++ library 
made it possible to simplify this program in a really impressive 
fashion. 

Unfortunately, my program worked correctly on my standard 
text fdes, but started bombing when I tried to read HTML fdes. 
After noodling with it for a while, I noticed that the program had no 


Can't find that bug from a past issue? The Windows Developer's 
Journal CD-ROM with full search capabilities is now available. 
See page 38 for more information. 


Mark Nelson is a programmer for Addisoft Consulting, Inc. in Dallas, Texas. 
Mark is the author of The C++ Programmer’s Guide to the Standard Template 
Library, from IDG Books, as well as The Data Compression Book, from M&T 
Books. You can reach Mark on the Web at http://web2.airmail.net/markn. 


problems when compiled with Borland, but failed regularly with 
Visual C++. 

Luckily for me, the discrepancy between the two compilers trig¬ 
gered the light bulb over my head. Just a few days earlier, I had read 
a series of messages in COI!ip.lang.C++ describing a problem with 
Microsoft’s string class. It seems that when a string longer than 32 
bytes is shortened to less than 32 bytes, serious heap damage 
occurs. 

I used Deja News (www.dejanews.com) to dig back through 
the newsgroup archives, and found a good description of the 
problem from Raymond Fergerson. f eb97bug. cpp (Listing 1) 
shows the program Raymond used to demonstrate the problem. 
When this program is compiled with debug libraries as described 
in the comments, it produces an error notification dialog as 
shown in Figure 1. 

Summary 

Steve Ross from Microsoft acknowledged this bug and indicated 
that it would be fixed in an unspecified upcoming release. The fix 
does not appear in “a” or “b” patches to VC++ 4.2, so we’ll have to 
patiently wait a while longer. 
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I personally owe a debt of gratitude to Raymond Fergerson for 
publicizing this bug. If past history is any judge, tracking this down 
to its source could have easily wasted a day of debugging time. 
Raymond’s warning cut that down to less than an hour, and I got a 
column out of it to boot! 

My thanks go out to Raymond along with a WDJ t-shirt. Please 
be sure to send me any interesting C++ bugs you encounter. If your 
report is selected for this column, you will win a newly designed 
WDJ t-shirt. I’ll look forward to hearing from you! □ 

[Download the code from Vim. wdj.com/source.htm.] 



Figure 1: Death by string handling 
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CreatePen returns a pen with the specified 
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DON'T ROB YOUR APPLICATION 
OF PERFORMANCE! 

Multithreaded programming in Microsoft Windows can be 
challenging — it's easy to accidentally throw away 30 - 50% (or 
more!) of available CPU bandwidth through over/undersleep, 
incorrect thread priorities, I/O blocking and mismanagement 
of synchronization objects like mutexes and critical sections. 

Thread PRO™ can help you find and eliminate these 
bottlenecks that are robbing your application of speed. It 
contains a microsecond-resolution profiler that measures not 
only absolute time elapsed, but also actual time executed in¬ 
thread. It also charts thread-switches and user-defined events, 
and can give you statistics on both duration and frequency of 
execution (a must for real-time apps). It can even detail 
operating system overhead and CPU usage of all other running 
processes! 

List price is $219 US - Introductory offer: only $179! Requires 
Windows 95/NT and genuine Intel Pentium CPU. 



CETASOFT 

952 Postal Way, Suite 1 2, Vista, California 92083 
Toll-free sales line: (888) 383-5050 Fax line: (619) 631-5858 
Technical info: (619) 631 -5855 or visit our website at www.cetasoft.com/wdj.html 
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Dan Shappir 


Detecting a Running Screen Saver 

Whether your customers use Windows 3.1, Windows 95, or Windows NT, the odds are 
good that they use screen savers. The ability to detect whether or not a screen saver is run¬ 
ning can be useful for several reasons. First, the fact that the screen saver is running means 
that Windows has determined that the machine is inactive, so a program might want to per¬ 
form background or idle-time tasks whenever a screen saver executes. Second, your program 
should avoid becoming a security risk by popping up a window when a screen saver is run¬ 
ning. Users often use passworded screen savers to secure their station while it is unattended, 
since Windows cooperates with such programs to prevent a user from switching to a differ¬ 
ent task. Except under NT, this security assumes that all mouse and keyboard input are 
directed to the screen saver window. If your application decides to display a window that 
acquires the input focus, the user will suddenly be able to call up the task list and kill the 
passworded screen saver. NT has a more secure scheme that thwarts this possibility. 

Unfortunately, while the Win32 API provides a variety of methods for manipulating and 
retrieving information about the screen saver, it lacks a straightforward mechanism for 
reporting whether or not a screen saver is currently running. I located several articles on the 
MSDN CD-ROM that demonstrate methods for detecting a running screen saver. While 
these methods provide good starting points, none of them was complete, reliable, or portable 
to all versions of Windows. This is mainly because of poor documentation on how to con¬ 
struct a Windows screen saver, and because changes to the specification of how Windows 
and screen savers interact have resulted in a lack of standardization. Thus, no single method 
is guaranteed to detect each and every screen saver on all the Win32 platforms. 

By combining the available methods and introducing some new techniques, I have man¬ 
aged to create a function that can detect nearly all running screen savers. In this article, I 
describe the implementation of the function ScreenSaverActi ve () that returns TRUE if the 
screen saver is currently running and FALSE otherwise. ScreenSaverActi ve( ) is compatible 
with all the current Win32 platforms including Win32s. 

Rejected Detection Methods 

I initially examined that several detection methods proved to be inappropriate or of limit¬ 
ed usefulness. One such method relies on the fact that just before it activates a screen saver, 
the Windows kernel sends a WM_SYSCOMMAND message with wPa ram set to SC_SCREENSAVE. An 
application that receives this message can even veto the activation of the screen saver by 
returning FALSE from its window procedure instead of passing the message to 
DefWi ndowProc () (this is the mechanism used by the screen savers to prevent one screen 
saver from running on top of another). Windows sends this message to the active application 
only, so if your program is not the foreground application, it won’t receive any notification 
that a screen saver kicked in. This method doesn’t help those programs that run automatical¬ 
ly and at a specific time to determine if a screen saver is already running. 

I also rejected the screen saver detection method that replaces the current screen saver 
with a specialized stub. When activated by the system, the stub could broadcast a special reg¬ 
istered window message to all the top-level windows. The stub would then spawn the “real” 
screen saver and wait until it terminates, at which point the stub could broadcast another mes¬ 
sage and exit. This method is simple to implement and is portable to all versions of Windows. 
It also has low overhead because it is event-driven and does not require constant polling of the 
screen saver state. It does, however, have several major drawbacks. I was reluctant to force the 
inclusion of an external executable in every project that required the ability to detect a running 
screen saver. Also, the user can use Control Panel to switch to a different screen saver at any 
time, and your program will have no way of knowing that the stub screen saver must be rein¬ 
stalled. Finally, if the screen saver is already running when the application installs the stub, it 
will not be detected. Therefore, I decided to forego this method. 

Under Windows 95, a screen saver is supposed to use $ystemParametersInfo( ) with the 
SP I_SCREENSAVERRUNN I NG flag to inform Windows that the saver has started or stopped. An 
application could then use SyStemParametersInfo () to inspect the current screen saver 
state. In practice, many screen savers fail to set this value (apparently with no ill effects). 



“By combining the 
available methods 
and introducing 
some new 
techniques, I have 
managed to create a 
function that can 
detect nearly all 
running screen 
savers. In this article, 
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implementation of 
the function 
ScreenSaverActive() 
that returns TRUE if 
the screen saver is 
currently running and 
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Dan Shappir holds a B.Sc. in Computer Science 
and has been a programmer for eight years. He is 
currently working for an Israeli computer firm 
developing interactive TV applications and multi¬ 
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Because it is unreliable and available only under Windows 95, I 
rejected this method as well. 

Detecting an NT Screen Saver 

Writing a screen saver detection routine for Windows NT was 
simpler than for the other Win32 platforms because NT is the only 
platform that implements desktops. A desktop is a secure object with 
a logical display surface that contains windows, menus, and hooks. In 
effect, a desktop virtualizes the traditional Windows desktop window 
that lies behind all the other windows. Only one desktop is active at 
any given time, and this desktop — also known as the input desktop 
— is the only one that is visible to the user and that receives user 
input. When NT automatically starts a screen saver, its Winlogon 
component creates a special desktop for the screen saver to execute 
on, and that desktop becomes the input desktop. This desktop is 
always named “screen-saver.” This mechanism provides a high level 
of security because even if an application creates a top-most window 
while the screen saver is running, it will be in another “invisible” 
desktop. (For more information on desktops, see Paula Tomlison’s 
“Understanding NT” column in the July 1996 issue of WDJ.) 

You can detect a running screen saver on Windows NT by testing 
for the existence of the screen saver desktop. The following code 
returns TRUE if it detects a running screen saver, and FALSE otherwise: 

HDESK hDesktop - OpenDesktopt 
TEXT("screen-saver"), 

0 , 

FALSE, 

MAXIMUM_ALLOWED); 


if ( hDesktop ) { 

CloseDesktop(hDesktop); 
return TRUE; 

} 

return GetLastError() 

— ERROR_ACCESS_DENIED; 

If the desktop exists and the calling thread has the appropriate 
access privileges, OpenDesktopt ) will succeed and return a handle 
to the desktop. If OpenDesktopt ) fails, it will return NULL and set the 
error state to indicate the cause of the failure. In this case, if 
GetLastError () returns ERROR_ACCESS_DENIED, the desktop exists 
but the calling thread cannot access it. If GetLastError () returns 
some other value (probably ERR0R_FILE_N0T_F0UND), the desktop 
does not exist. 

This method is reliable but incomplete. It will not report that a 
screen saver is running if that is not actually the case, but it will some¬ 
times report that no screen saver is running when one actually is. If the 
user starts a screen saver explicitly, using the preview button on the 
Windows Control Panel, the screen saver will run in the current desk¬ 
top instead of its own special desktop. As a result, the code will indi¬ 
cate that the screen saver isn’t running when it really is. The solution is 
to augment the detection routine with code based on the following: 

return FindWindowt 

TEXTC'WindowScreenSaverClass"), 

NULL) !- NULL; 


continued on page 50 
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LPA’s industry-leading 32-bit Prolog compiler provides 
everything you need to build entire graphical Windows 
applications, or just to add intelligence to C/C++, 
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sub2 USERS: main 

CALLS: sub3 sub4 
PARAM: argl arg2 
LOCAL: varl 
... GLOBL: var2 ^yar3^ 


filel main 

file2 
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file2 

1—sub3 
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file2 

filel 

— main(recursv) 
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continued from page 47 

This code checks for the existence of a window of the class 
Wi ndowScreenSaverCl ass (the window class that screen savers are 
supposed to use) within the current desktop. As I will show, this 
additional check is also incomplete, but the combination of the two 
is sufficient, according to my tests. 

Detecting a Win32s orWin95 Screen Saver 

Since Windows 95 and Win32s do not implement desktops, my 
original detection code for these platforms consisted only of the 
second part of the NT detection routine (searching for a window of 
class WindowScreenSaverClass). However, this method alone 
turned out to be insufficient. Some screen savers do not name their 
window class “WindowScreenSaverClass”, so the call to 
FindWindowO fails. Also, some screen savers use 
WindowScreenSaverClass for their window’s class even when in 
configuration mode (the mode where you set the screen saver’s 
password, for example) and the new small window preview mode 
(the Windows 95 feature that shows the screen saver running in a 
small screen inside the Control Panel). While the screen saver is 
technically running in these instances, they do not represent system 
idle time. I wanted a detection method that could distinguish 
between these modes and the actual saver mode. 

To solve the second problem, I relied on the expected attributes 
of the window in screen saver mode. To qualify as belonging to a 
running screen saver, the window whose handle was returned by 
Fi ndWi ndow( ) must be top-most (have the WS_EX_T0PMOST extended 
style), full-screen, or have no parent window. Most screen savers 
create their window as top-most and full-screen. I have, however, 
encountered a few that did not. Checking whether or not the win¬ 
dow has a parent can make the distinction for these screen savers as 
well. When a screen saver runs in configuration mode or small win¬ 
dow preview mode, it should create its window as a child of a win¬ 
dow whose handle is given on the command line (as a decimal 
string). If a handle is not provided, then the screen saver should use 


SDK Annotation #168 

TYPE: Win32 

TOPIC: WindowFromPoint 

KEYWORD: WindowFromPoint 

If given a point over a static text control, 
WindowFromPoint() returns the handle of the 
window “under” the static text control. 

Submitted by Muthuvale Shanmugam. 
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whichever window is currently in the foreground for a parent. In 
screen saver mode, the window usually does not have a parent. 

Solving the first problem — identifying screen savers that 
neglect to use a window class named “WindowScreenSaverClass” 
— required that I add another method of detection. The method I 
selected was to examine the filename extension of the executable 
that owns the current foreground window. Screen savers are unique 
among Windows executables because they have the . scr extension. 
Thus, if the window’s owner has this extension, a screen saver must 
be running. But how do you get the owning executable filename? 

Before explaining the methods I use to obtain this information, I 
must point out that the concept of a foreground window is new to 
Win32 and does not exist in 16-bit Windows. Under 16-bit 
Windows 3.x, the system has a single active window that receives 
user input. Although it is technically a Win32 platform, Win32s 
behaves like 16-bit Windows in this respect. Thus, the Win32s 
screen saver detection routine uses GetActi veWindow( ) to obtain 
the handle to the window that receives user input. In Windows 95 
and Windows NT, each thread can have its own active window. The 
foreground window is the active window that belongs to the fore¬ 
ground thread. For this reason, the Windows 95 detection routine 
uses GetForegroundWi ndow( ) instead of GetActi veWi ndow( ). Note 
that if you call GetForegroundWindow( ) when running on Win32s 
the function will always fail (return NULL), but for the sake of brevi¬ 
ty I will refer to the window that receives the user input as the fore¬ 
ground window for all the Win32 platforms. 

My first approach for obtaining the executable file name was very 
straightforward: get the handle of the instance that created the fore¬ 
ground window using GetWi ndowLong () with the GWL_HINSTANCE flag, 
and then pass this handle to GetModul eFi 1 eNamef ). Although 
GetModul eFi 1 eName () expects a parameter of type HMODULE rather 
than HINSTANCE, this does not pose a problem because these types are 
interchangeable for Win32. This method worked correctly on Win32s 
(completing the detection routine for that platform) but failed 
abysmally for 32-bit applications running on Windows 95. 
GetModul eFi 1 eName () either failed or returned the name of my test 
application instead of the name of the application that created the cur¬ 
rent foreground window. 

In retrospect, I should have anticipated this behavior. Under 16-bit 
Windows, an application’s instance handle is simply a pointer to its 
default data segment. Because all the modules ran in the same address 
space, and each instance of a module has its own data segment, an 
instance handle can uniquely identify each module instance in the sys¬ 
tem. Win32s resides on top of 16-bit Windows, and also provides a sin¬ 
gle address space for all the running applications, so it too can use 
instance handles as global identifiers. Windows 95 and Window NT, 
on the other hand, run each process in its own separate virtual address 
space. Because instance handles are still implemented as memory 
pointers (the address where the executable was loaded), they become 
meaningless outside the context of the process to which they belong. 
This is why WinMainO’s hPrevious parameter is always NULL under 
Win32. Also for this reason, if my test application happened to be 
loaded at the same virtual address as the module that created the fore¬ 
ground window, GetModul eFi 1 eNamef) returned the test application 
module name; otherwise it failed. 

TOOLHELP32 to the Rescue 

Since the Win32 GetModul eFi 1 eNamef ) works only for your 
own executable and any DLLs it has loaded, I needed a different 
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algorithm to obtain module’s filename from its instance handle. 
Fortunately, the Win95 ToolHelp32 functions can help. The 
ToolHelp32 API consists of twelve functions in five categories: 
process enumeration, thread enumeration, module enumeration, 
heap enumeration, and miscellaneous. The process and thread enu¬ 
meration functions provide information on all processes and threads 
in the system, providing exactly the information I required. 

To use ToolHelp32 (which is available only under Win95), you 
must include tl hel p32. h. Depending on how your compiler pack¬ 
age structures its import libraries, you may also have to add 
th32.1 i b to your list of libraries. I chose the more unwieldy method 
of explicitly calling Load Li bra ry() and GetProcAddresst ); I could 
not implicitly link via an import library because I wanted my code 
to work correctly on Win32s and NT, where the ToolHelp32 rou¬ 
tines are not available. 

To use ToolHelp32 to obtain a filename from an instance handle, 
I first call CreateTool hel p32Snapshot( ) to create a “snapshot” of 
the current system state. The function’s first parameter is a flag that 
specifies which system list you want to traverse; I use the 
TH32CS_SNAPPR0CESS flag to indicate that I want to traverse the 
process list. If successful, CreateTool hel p32Snapshot( ) returns a 
handle to a kernel object that contains the requested information. 
When you no longer require the information, close the handle using 
CloseHandleO. 

Once you obtain the snapshot object, you can iterate through the 
list of active processes with Process32First() and 
Process32Next( ). Both functions take the handle returned by 
CreateTool hel p32Snapshot() as their first parameter and a pointer 
to a PR0CESSENTRY32 structure as the second parameter. If the func¬ 
tions succeed, they fill the PR0CESSENTRY32 structure with informa¬ 
tion about a particular process in the list. This structure contains the 
following fields: 


typedef struct tagPR0CESSENTRY32 


{ 

DWORD dwSize; 

DWORD cntUsage; 

DWORD th32ProcessID; 

DWORD th32DefaultHeapID; 
DWORD th32ModuleID; 

DWORD cntThreads; 

DWORD th32ParentProcessID; 
LONG pcPriClassBase; 

DWORD dwFlags; 

char szExeFile[MAX_PATH]; 

} PR0CESSENTRY32; 


// this process 

// associated exe 

// parent process 
// base priority 

// path 


dwSize must be set to the size of the structure before calling 
Process32Fi rst( ). I locate the process corresponding to the 
screen saver by comparing the th32ProcessID field to the value 
returned by GetWi ndowThreadProcessId( ), which I use to identi¬ 
fy the process that created the foreground window. When I find the 
correct process, s z Exe File contains the name of the process. If 
the last four characters of this field are “.SCR”, then this is a 
screen saver. As in the previous test, the window created by the 
screen saver process must be top-most or full-screen or have no 
parent window. 

The Implementation 

I implemented the techniques I’ve discussed in a routine called 
ScreenSaverActi ve( ), which resides in ssdetect.cpp (Listing 1). 
To call it from your C++ program, just include the prototype: 


BOOL ScreenSaverActive(void); 

The source code also contains IsFul 1 Screen( ), a function that 
returns TRUE if a given window covers the entire screen. This func¬ 
tion is used internally by the screen saver detection routine but is 
also useful by itself. The electronic distribution of the code (see 
Table of Contents for availability) contains a sample program that 
uses the screen detection routine; it sets a one-second timer and 
beeps on each timer interval it finds a screen saver running. The exe¬ 
cutable generated from this sample will work on all the Win32 plat¬ 
forms. If you use Visual C++ v4.2, you should be aware that it no 
longer supports Win32s. If you want to target Win32s, you must 
stick to previous versions of Microsoft’s compiler. 

As previously stated, I link to the ToolHelp32 routines dynami¬ 
cally using Load Li bra ry( ) and GetProcAddress (); it’s more com¬ 
plicated than linking with th32.1 i b, but that would restrict the code 
to Windows 95.1 did create a class to simplify using the ToolHelp32 
routines. CTooTHelp is a class whose constructor handles the 
dynamic linking, and whose member functions provide access to 
ToolHelp32 functions. CTool Hel p’s destructor frees up the handle 
LoadLibraryO returned. 

Conclusion 

Because of the many differences between the various Win32 
platforms, writing a screen saver detection routine that is both reli¬ 
able and portable turned out to be more difficult than I had original¬ 
ly anticipated. This task would have been much easier had the 
designers of the Win32 API seen fit to provide a straightforward 
mechanism for obtaining this information. Using 
ScreenSaverActi ve( ), you can create applications that effectively 
monitor system idle time on all the Win32 platforms. Also using this 
function, you can avoid jeopardizing system security by not inad¬ 
vertently taking the input focus away from a running screen saver 
on Windows 95 and Win32s. □ 

[Download the code from mvt. wdj. com/ source . htw.] 


Listing 1; ssdetect.cpp — A Win32 screen saver 
detector 


/* 

ssdetect.cpp 

Written by Dan Shappir 1996. 

*/ 

jfifndef STRICT 
//define STRICT 1 
//end if 

jfifndef WIN32_LEAN_AND_MEAN 
//define WIN32_LEAN_AND_MEAN 
//end if 

//ifndef WI N32_EXTRA_LEAN 
//define WIN32_EXTRA_LEAN 
ffendif 

//include <windows.h> 

//include <tlhelp32.h> 

const LPCTSTR SS_WIND0W_CLASS - TEXTC'WindowsScreenSaverClass”); 

const LPCTSTR SS_EXT - TEXT!".SCR"); 

const int SS_EXT_LEN - 1strlen(SS_EXT): 

const LPTSTR SS_DESK - TEXTC'screen-saver"); 

const LPCTSTR TH_DLL - TEXTCKERNEL32.DLL"); 

const LPCTSTR TH_SNAPSHOT - TEXT("CreateToolhelp32Snapshot"); 

const LPCTSTR TH_FIRST - TEXT("Process32First”); 

const LPCTSTR TH_NEXT - TEXT("Process32Next"); 
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Listing 1: ssdetect.cpp — continued 


static DWORD GetOSVersIon() 

{ 

OSVERSIONINFO verlnfo; 

verlnfo.dwOSVersionlnfoSIze - sizeof(verlnfo): 
GetVersionExf&verlnfo); 
return verlnfo.dwPlatformld; 

} 

const DWORD OSJERSION - GetOSVersion(); 

static BOOL IsTopmost(HWND hWnd) 

{ 

return (GetWindowLongthWnd. GWL_EXSTYLE) & WS_EX_TOPMOST) !- 0: 

) 


static BOOL IsNotConfigureOrPreview(HWND hWnd) 
t 

extern BOOL IsFullScreenlHWND hWnd); 

return IsWindow(hWnd) SS 

( GetParent(hWnd) — NULL || IsTopmostChWnd) || 

IsFul1 Screen(hWnd) ); 

} 

static BOOL ScreenSaverClassRunningO 

{ 

HWND hWnd - FindWindow(SS_WINDOW_CLASS. NULL); 
return IsNotConfigureOrPreview(hWnd); 

} 

static BOOL ScreenSaverActiveNTO 

{ 

HDESK hDesktop - OpenDesktoptSS_DESK,0,FALSE,MAXIMUM_ALLOWED); 
if ( hDesktop ) { 

CloseDesktop(hDesktop); 
return TRUE; 

} 

return GetLastErrorO — ERROR_ACCESS_DENIED; 

) 

static BOOL HasScreenSaverExtfLPCTSTR 1pszName) 

{ 

int length - lstrlen(lpszName); 
return length >= SS_EXT_LEN M 

1strcmpi(1pszName+1ength-SS_EXT_LEN, SS_EXT) — 0; 

) 

static BOOL ScreenSaverActiveW32s() 


(GetProcAddress Cm_library, TH_FIRST)); 
m_nextProcess - reinterpret_cast<FIND_PROCES$> 
(GetProcAddress(m_library. TH_NEXT)); 

} 

} 

el se 

m_createSnapshot - NULL; 


CToolHelp::~CToolHelp() 

{ 

if ( mjibrary ) 

FreeLibrary(m_library); 

) 

HANDLE CTooTHelp::FirstProcess(PR0CESSENTRY32& pe) const 
{ 

if ( mjextProcess ) { 

HANDLE hSnapshot - 

m_createSnapshot(TH3-2CS_SNAPPR0CESS, 0); 
if ( hSnapshot ) { 

pe.dwSize - sizeof(PR0CESSENTRY32); 
if ( m_firstProcess(hSnapshot, Ape) ) 
return hSnapshot; 

CloseHandle(hSnapshot); 

) 

} 

return NULL; 

} 

static BOOL ScreenSaverActiveW95() 

{ 

HWND hWnd - GetForegroundWindowO; 
if ( IsNotConfigureOrPreview(hWnd) ) { 
static CToolHelp ToolHelp; 

PR0CESSENTRY32 pe; 

HANDLE hSnapshot - ToolHelp.FirstProcess(pe); 
if ( hSnapshot ) ! 

DWORD dwProcessId; 

GetWindowThreadProcessldChWnd, SdwProcessId); 
do { 

if ( dwProcessId — pe.th32ProcessID ) { 

CloseHandle(hSnapshot); 

return HasScreenSaverExtCpe.szExeFi1e) ; 

) 

) while ( ToolHelp.NextProcess(hSnapshot. pe) ); 
CloseHandle(hSnapshot); 

1 

) 

return FALSE; 


HWND hWnd - GetActi veWi ndow(); 

if ( IsNotConfigureOrPreview(hWnd) ) { 

HINSTANCE hlnstance - reinterpret_cast<HINSTANCE> 

(GetWindowLongC hWnd. GWL_HINSTANCE)); 
if ( hlnstance ) { 

TCHAR szBuffer[MAX_PATH]; 

GetModuleFileNameChlnstance,szBuffer.si zeof(szBuffer)); 
return HasScreenSaverExt(szBuffer); 

) 

} 

return FALSE; 


class CToolHelp { 

typedef HANDLE (WINAPI *CREATE_SNAPSHOT)(DWORD, DWORD); 
typedef BOOL (WINAPI *FIND_PROCESS)(HANDLE, LPPR0CESSENTRY32); 

HINSTANCE mjibrary; 

CREATE_SNAPSHOT m_createSnapshot; 

FIND_PR0CESS m_firstProcess; 

FINDJ’ROCESS mjextProcess; 


struct CScr { 
const int H, W; 

CScr() ; WCGetSystemMetrics(SM_CXSCREEN)), 

H(GetSystemMetrics(SM_CYSCREEN)) {) 

}; 


BOOL IsFullScreenCHWND hWnd) 

( 

if ( IsWindowVisible(hWnd) ) [ 

WINDOWPLACEMENT wp; 
wp.length - sizeof(wp); 
if ( GetWindowPlacement(hWnd, 8wp) 88 
wp.showCmd !- SW_SHOWMINIMIZED ) { 

CScr scr; 

RECT r; 

return GetWindowRect(hWnd, &r) AS 

r.left <- 0 SS r.right >- scr.W SS 
r.top <- 0 SS r.bottom >- scr.H; 


return FALSE; 


public: 

CToolHelpO; 

-CToolHelpO; 

HANDLE FirstProcess(PROCESSENTRY32S pe) const; 

BOOL NextProcesstHANDLE hSnapshot, PR0CESSENTRY32S pe) const 

{ 

return m_nextProcess(hSnapshot, Spe); 

} 

}; 

CToolHelp::CToolHelp() ; mjibrary(LoadLibrary(TH_DLL)) 

{ 

if ( mjibrary ) { 

m_createSnapshot - reinterpret_cast<CREATE_SNAPSHOT> 
(GetProcAddress(mjibrary, TH_SNAPSH0T)); 
if ( m_createSnapshot ) { 

m_firstProcess - reinterpret_cast<FIND_PROCESS> 


BOOL ScreenSaverActive() 

{ 

if ( ScreenSaverClassRunningO ) 
return TRUE; 

switch ( OSJERSION ) { 

case VER_PLATF0RM_WIN32_NT: 

return ScreenSaverActiveNTO; 
case VER_PLATF0RM_WIN32s: 

return ScreenSaverActiveW32s(); 
case VER_PLATF0RM_WIN32_WINDOWS: 
return ScreenSaverActiveW95(); 

) 

return FALSE; 

} 

// End Of File 
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Mitch Stuart 


A Reusable Network Enumeration 
Class 

If you use a networked Windows PC, you have probably used Explorer or File Manager 
to browse network resources and connect to a shared disk volume, directory, or printer. If 
you’ve ever wondered how such programs generate the list of network objects, or how you 
can add network browsing to your own application, this article is for you. 

This article explains the concepts behind the network hierarchy and network enumera¬ 
tion, and presents a reusable class that you can drop into your application to add network 
browsing capabilities. The included sample program (see Figure 1) shows how to use the 
enumeration class. The code is portable across Windows 95 and NT, and I discuss both 
Microsoft Windows and Novell NetWare environments. 

Network Hierarchy 

The model for Win32 network objects is strongly hierarchical: the network “tree” 
contains a series of levels, each of which can contain a particular type of network object 
or “node.” 

The top level of the network hierarchy is simply an abstract container which provides a 
starting point for locating network resources. For example, in the Windows 95 Explorer or 
Network Neighborhood, the item “Entire Network” represents the top level of the network. 
In Figure 1, the “Network” node at the top of the tree control serves the same purpose. 

The second level is for network providers such as Microsoft, Novell, Banyan, IBM. and 
so on. Any network protocol vendor whose software you install on your computer becomes 
a network provider in the tree. In Figure 1, the “Microsoft Network” and “NetWare” items 
are network providers. 

The third level is for domains or workgroups, which are used in Microsoft networks but 
not in NetWare. Domains and workgroups allow network administrators to create logical 
groupings of computers. Workgroups can be fairly ad hoc: when you set up Windows 95 or 
NT, you can create a new workgroup or join an existing one. Domains, on the other hand, 
must be set up in advance by an administrator and each domain must contain at least one NT 
Server. In Figure 1, “ENGINEERING” and “MARKETING” (under the Microsoft 
Network) are workgroups. NetWare does not support the concept of workgroups, so none 
appear in Figure 1 under NetWare. 

The fourth level of the network hierarchy is for computers. In a Microsoft network, 
the computers on this level could be workstations running Windows 95 or NT 
Workstation, or servers running NT Server. In a NetWare network, the computers are 
NetWare servers that offer file and print services. In Figure 1, “SYDNEY” and "ADE¬ 
LAIDE” are examples of computers. 

The fifth level is for “shares,” such as shared directories and printers. In a Microsoft net¬ 
work, anyone can elect to share any of their disk drives, directories, or local printers across 
the network using facilities built into the operating system. In NetWare, shares are objects 
such as disk volumes and print queues set up by the administrator. In Figure 1, 
\\SYDNEY\CDRIVE is an example of a shared disk directory (actually an entire drive, since the 
root directory is shared), and \\ADELAIDE\LASER1 is an example of a shared printer. 

The hierarchy contains other types of network objects. For example, if you are running 
NetWare 4, you will have one or more NetWare Directory Services (NDS) trees as part of 
your network. 

Network Enumeration 

Network enumeration is the process of querying the system for information about net¬ 
work objects and the relationships between those objects. In Win32, enumeration uses the 
NETRESOURCE data structure, and the WNetOpenEnum( ) and WNetEnumResource( ) API func¬ 
tions, all of which can be found in winnetwk.h. The details of these functions and the 
NETRESOURCE structure can be found in the SDK documentation, but here is summary of 
how to use them: 
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1. Call WNetOpenEnum( ), passing in a NULL NETRESOURCE pointer to 
indicate that enumeration should begin at the top of the network 
hierarchy. 

2. Call WNetEnumResource( ) with the enumeration handle that was 
returned from WNetOpenEnumO. WNetEnumResoiircet ) will return a 
set of NETRESOURCE structures with information about the network 
objects which are contained within the context of the enumeration 
handle that you pass in. For example, if you call these functions for 
a workgroup object, you will get back a list of all the computers in 
that workgroup. In Figure 1, the right half of the dialog displays the 
information returned in the NETRESOURCE structure. 

3. After executing one set of OpenEnum( )/EnumResource( ) calls, 
you can use each of the NETRESOURCE structures returned from 
EnumResource () to pass into additional OpenEnumO calls to 
begin new enumerations. This is how you “drill down” through 
the various network levels. 

The enumeration API discussed above is part of Microsoft’s 
“Multiple Provider Router” (MPR) network architecture and resides 
in mp r. d 11, which should be in your Win95 or NT system directory. 


For Visual C++, the import library for this DLL is not part of the 
standard build settings, so you need to add mpr .lib to your library 
input modules in your build settings or makefile. 

The CNetNode Class 

For easier network enumeration, I wrote the CNetNode class, 
which encapsulates information about a particular network node 
and supports enumeration of the node’s children. The class interface 
is in netnode.h (Listing 1) and the implementation is in 
netnode.cpp (Listing 2). The key member variables are 
m_pNetResource, which points to a NETRESOURCE structure holding 
the node’s properties, and m_nodeArray, which is an array of 
CNetNode objects representing the children of the current node. 

CNetNode has two constructors. The default constructor (i.e., the 
one without any parameters) constructs the root node of the tree. Use 
the other constructor for all other nodes; it takes an LPNETRESOURCE 
parameter, which describes the node being constmcted. 

Here is how to use CNetNode to enumerate the entire network 
hierarchy: 

1. Construct the root node using the default constructor. 

2. Call the root node’s En umerateNetwork() member function. 

3. Call the GetChi 1 dCountC ) member function to determine how 
many child nodes were created by EnumerateNetwork(). 

4. If at least one child node was created, use the GetChi 1 dNode() 
member function to get each child node in turn, and call the 
EnumerateNetWOrk( ) member function for each child node. 

5. Continue steps 3 and 4 until GetChi 1 dCount () returns zero, 
indicating that the current branch of the network tree is fully 
enumerated. 

6. As each node is created, use the “Get...” functions 
(GetProvidert), GetTyped, etc.) to retrieve the properties of 
the node. 



Figure 1: Demonstrating the CNetNode class 


Listing 1: netnode.h — Interface for CNetNode class 

{ return(m_pNetResource->lpProvider); } 
inline DWORD GetScopeO 

// netnode.h 

{ return(m_pNetResource->dwScope) ; } 
inline DWORD GetTypeO 

#1fndef _NETNODE_H_ 

{ return(m_pNetResource->dwType); } 

^define _NETNODE_H 

inline DWORD GetDisplayTypeO 


( return(m_pNetResource->dwDisplayType); } 

^include <winnetwk.h> // network APIs 

inline DWORD GetUsageO 
{ return(m_pNetResource->dwl)sage); } 

class CNetNode 

j { 

// platform utility 

public: 

static inline int GetPlatformIDO 

// construction/destruction 

( if (m_platforralD >- 0) return(m_platfomID); 

CNetNodeO; 

else returndnitPlatformlDO); ) 

CNetNode!LPNETRESOURCE pNetResource); 

static inline int PlatformlsWindows95() 

-CNetNode!); 

{ return(GetPlatformlDC) -- 
VER_PLATFORM_WIN32_WINDOWS); } 

// network enumeration 

static inline int PIatformlsWindowsNTC ) 

DWORD EnumerateNetworkO; 

{ returnCGetPlatformlDC ) — 

inline DWORD GetChildCount! ) 

V E R_P LATFORM_WIN32_NT ); } 

{ return(m_nodeCount) ; } 

inline CNetNode * GetChi1dNodetDWORD index) 

protected: 

{ return<m_nodeAr ray [ i ndex] ); } 

void EnumerateWin95NetProviders ( char * 


pNetProvIders, DWORD * pNumNetProviders ); 

; // query network node details 

DWORD EnumerateNetworkWin95Root( ); 

inline BOOL IsContainerO 

static int InitPlatformlDC ); 

{ return(m pNetResource->dwUsage & 

RESOURCEUSAGE.CONTAINER); } 

static int m_p 1 atformlD ; 

inline const char * GetTextO 

BOOL m_isRoot; 

{ return(m_text); } 

BOOL m_haveEnumerated; 

inline const char * GetLocalName!) 

char * m_text; 

{ return(m_pNetResource->lpLocalName); } 

CNetNode ** m_nodeArray; 

inline const char * GetRemoteName!) 

DWORD m_nodeCount; 

{ return(m_pNetResource->lpRemoteName); } 

LPNETRESOURCE m_pNetResource; 

inline const char * GetComment!) 

}; 

{ return(m_pNetResource->lpCorament); } 

inline const char * GetProvider!) 

vendIf // NETNODE H 
// End of File 


54 


• windows developer’s journal • www.wdj.com • 


February 1997 


















Listing 2: netnode.cpp — Implementation for 
CNetNode class 


II netnode.cpp 

#include "windows.h” 

#include "netnode.h" 

// Initialize static data members 
int CNetNode::m_platformlD - -1; 

// The default constructor is to create the root node 
CNetNode::CNetNode() : 
m_haveEnumerated(FALSE). 
m_isRoot(TRUE). 
m_pNetResource(NULL). 
m_nodeArray(NULU, 
m_nodeCount(0) 

{ 

m_text - "Network"; // top-level network node 

m_pNetResource - new NETRESOURCE; 
m_pNetResource->dwScope - RESOURCE_GLOBALNET: 
m_pNetResource->dwType - RESOURCETYPE_ANY; 
m_pNetResource->dwUsage - RESOURCEUSAGE_CONTAINER; 
m_pNetResource->dwDisplayType - RESOURCEDISPLAYTYPE_ROOT: 
m_pNetResource->lpLocalName - NULL; 
m_pNetResource->lpRemoteName - NULL; 
m_pNetResource->lpComment - NULL; 
m_pNetResource->lpProvider - NULL; 

1 

// This constructor constructs a non-root node, such as 
// a network provider, workgroup/domain, computer, or share 
CNetNode::CNetNode(LPNETRESOURCE pNetResource) : 
m_haveEnumerated(FALSE), 
m_isRoot(FALSE), 
m_nodeArray(NULL). 
m_nodeCount(0) 

{ 


// Calculate the size of the netresource structure 
// plus the strings that it points to 
DWORD size - sizeof(NETRESOURCE); 

if (pNetResource-MpLocalName) 
size +- (strlen(pNetResource->lpLocalName) + 1); 
if (pNetResource->lpComment) 
size +- (strlen(pNetResource->lpComment) + 1); 
if (pNetResource->lpProvider) 
size +- (strlen(pNetResource-)lpProvider) + 1); 
if (pNetResource->lpRemoteNaroe) 
size +- (strlen(pNetResource->lpRemoteName) + 1); 

// Allocate a contiguous block of memory for the 
// netresource and its strings 
m_pNetResource - (LPNETRESOURCE) new char[size]; 

// Copy the base netresource structure 
memcpy(m_pNetResource, pNetResource, 
sizeof(NETRESOURCE)); 

// Move the strings into the new netresource area 
char * pString - ((char *) mjNetResource) + 
sizeof(NETRESOURCE); 

if (pNetResource->lpLocalName) 

{ 

strepy(pString, pNetResource->lpLocalName); 

m_pNetResource->lpLocal Name - pString; 

pString +- (strlen(pNetResource->lpLocalName) + 1); 

) 

if (pNetResource->lpComment) 

{ 

strepy(pString, pNetResource->lpComment); 

m_pNetResource->lpComment - pString; 

pString +- (strlen(pNetResource->lpComment) + 1); 

} 

if (pNetResource->lpProvider) 

( 
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Listing 2: netnode.cpp — continued 


strcpy(pString, pNetResource->lpProvider); 

mjNetResource->lpProvider - pString; 

pString +- (strlen(pNetRe$ource->lpProvider) + 1); 

) 

if (pNetResource->lpRemoteName) 

{ 

strcpy(pString, pNetResource->lpRemoteName); 
mjNetResource->lpRemoteName - pString; 
nLtext - pString; 

pString +- (strlen(pNetResource->lpRemoteName) + 1); 

} 

else 

( 

m_text - "Unknown"; 

} 

} 


CNetNode::~CNetNode() 

( 

if (m_pNetResource) 
delete mjNetResource; 

// Delete all child nodes 
for (DWORD 1 - 0; i < mjodeCount; i++) 
{ 

if (mjodeArrayti]) 
delete m_nodeArray[i]; 

} 

delete [] mjodeArray; 
mjodeArray - NULL; 
mjodeCount - 0; 


DWORD CNetNode;:EnumerateNetwork() 

{ 

static const DWORD ENUM_BUF_SIZE - 16000; 

if (m_haveEnumerated) 
return(0); 

// Special case for Win95 root node 
if (mJsRoot && PIatformlsWIndows95()) 
returnC EnumerateNetworkWin95Root()); 

DWORD enumBufSize - ENUM_BUF_SIZE; 

DWORD enumNumEntries - Oxffffffff; 

HANDLE hEnum - NULL; 

LPNETRESOURCE pNetResBuf - NULL; 

DWORD ret - 0; 

ret - WNetOpenEnumC RESOURCE_GLOBALNET, 
RESOURCETYPE_ANY, 

0, 

mjNetResource, 

&hEnum); 

if (ret - N0_ERR0R) 

{ 

pNetResBuf - (LPNETRESOURCE) new char[enumBufSize]; 

ret - WNetEnumResource(hEnum, 

SenumNumEntries, 

pNetResBuf, 

SenumBufSize); 


if (ret — NO.ERROR) 

{ 

m_haveEnumerated - TRUE; 

mjodeCount - enumNumEntries; 

m_nodeArray - new CNetNode * [mjodeCount]; 

memsettmjodeArray, 0, mjodeCount * sizeof(CNetNode *)); 

CNetNode * pNetNode; 

for (DWORD i - 0; i < enumNumEntries; i++) 

{ 

pNetNode - new CNetNode(&pNetResBuf[i]); 
mjodeArrayfi] - pNetNode; 

} 


if (pNetResBuf) 
delete [] pNetResBuf; 


if (hEnum) 

ret - WNetCloseEnum(hEnum); 
return(ret); 

} 

int CNetNode::InitPlatformID() 

{ 

if (mjlatformlD < 0) 

( 

0SVERSI0NINF0 osvi; 

memset(&osvi, 0, sizeof(OSVERSIONINF0)); 

osvi.dwOSVersionlnfoSize - sizeof(OSVERSIONINFO); 

DWORD ret - ::GetVersionEx(&osvi); 

mjlatformlD - osvi.dwPlatformld; 

} 

return(m_platformID); 

} 


DWORD CNetNode::EnumerateNetworkWin95Root() 

( 

// Win95 does not return the top-level network providers 
// in the same manner as NT, so we get the provider names 
// from the registry, 
char netProviders[4096]; 

DWORD numProviders; 

EnumerateWin95NetProviders(netProviders, SnumProviders); 

if (numProviders -- 0) 
return(ERR0R_N0_NETW0RK); 

CNetNode * pNetNode; 

m_haveEnumerated - TRUE; 

mjodeCount - numProviders; 

mjodeArray - new CNetNode * [mjodeCount]; 

memsetlmjodeArray, 0, mjodeCount * sizeof(CNetNode *)); 

NETRES0URCE netResource; 
netResource.dwType - RESOURCETYPE.ANY; 

#if(WINVER >- 0x0400) 

netResource.dwDisplayType - RESOURCEDISPLAYTYPE_NETW0RK; 
#else 

netResource.dwDisplayType - RESOURCEDISPLAYTYPE_GENERIC; 
(fendif 

netResource.1pLoca1 Name - NULL; 
netResource.1pRemoteName - NULL; 
netResource.lpComment - NULL; 
netResource.dwUsage - RES0URCEUSAGE_C0NTAINER: 
netResource.dwScope - RES0URCEJ5L0BALNET; 

char * pNetProvider - netProviders: 
for (DWORD 1 - 0; i < numProviders; 1++) 

{ 

netResource.IpProvider - pNetProvider; 
pNetNode - new CNetNode(inetResource); 
mjodeArrayfi] - pNetNode; 
pNetNode->m_text - 

pNetNode->mjNetResource->lpProvider; 
pNetProvider - pNetProvider + strlen(pNetProvider) + 1; 

} 

return(O); 


void CNetNode;:EnumerateWin95NetProviders(char * 
pNetProviders, DWORD * pNumNetProviders) 

{ 

// This routine is specific to Win95, because the registry 
// structure on NT is slightly different 
DWORD ret; 

HKEY hKeyProviderOrder - NULL; 

HKEY hKeyProviderName - NULL; 

ret - Reg0penKeyEx(HKEY_L0CAL_MACHINE, 
"SystemWCurrentControlSetW" // continued... 

"control WNetworkProviderWOrder", 

0 , 

KEY_QUERY_VALUE, 

ShKeyProviderOrder); 

if (ret) 
return; 

char provi derServiceName[MAX_PATH]; 

char providerData[MAX_PATH]; 

char providerNameKey[MAX_PATH]; 

char providerName[MAX_PATH]; 

DWORD buflenProviderServiceName; 
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The Network Root Node 

The default CNetNode constructor populates a NETRESOURCE 
structure designed to enumerate the very top level of the network. 
This is the most typical usage; however, there may be times when 
you want to create a root node that does not represent the entire net¬ 
work, but instead represents a specific subset. For example, you 
could set the 1 pProvider field to a specific network provider (say, 
“NetWare” under Windows 95) to see only the objects in that 
provider’s part of the network tree. You could easily modify the 
CNetNode root constructor to allow specification of a starting point 
in the network hierarchy. 

If you do want to begin at the very top of the network tree, it is 
not necessary to create a starting NETRESOURCE: you can just pass in 


Listing 2: netnode.cpp — continued 


DWORD buftenProviderName; 

DWORD buf1enData; 

DWORD regType; 

DWORD index - 0; 

while (1) 

1 

buflenProviderServiceName - MAX_PATH; 
buftenProviderName - MAX_PATH; 
buf 1 enData - MAX_PATH; 

// Get a network provider "service name" 
ret - RegEnumValue(hKeyProviderOrder, 
index, 

providerServiceName, 

SbuflenProviderServiceName, 

NULL, 

SregType, 

(LPBYTE) providerData, 

&buf1enData); 

if (ret) 
break; 

strcpytproviderNameKey, 
"SystemWCurrentControlSetWServicesW"); 
strcattproviderNameKey, providerServiceName); 
strcat (provi derNameKey, "WNetworkProvider"); 

ret - RegOpen Key Ex(HKEY_LOCAL_MACHIN E, 
providerNameKey, 

0, 

KEY_QUERY_VALUE, 

&hKeyProviderName); 

if (ret) 
break; 

// Get the provider name 
ret - RegQueryVa1ueEx(hKeyProviderName, 
"Name", 

NULL, 

SregType, 

(LPBYTE) providerName, 

SbuflenProviderName); 

if (hKeyProviderName) 

RegCloseKey(hKeyProviderName); 

if (ret) 
break; 

strcattpNetProviders, providerName); 
pNetProviders - pNetProviders + 
strlen(providerName) + 1; 
index++; 

1 

if (hKeyProviderOrder) 

RegCt oseKey(hKeyProviderOrder); 

*pNumNetProviders - index; 

1 

//End of File 


NULL to WNetOpenEniimt ), and the system will understand that you 
are enumerating the entire network. This works perfectly under NT, 
but I was not able to get it to work under Win95. I could not get 
Win95 to recognize all of the network providers that I had installed, 
so I kept getting an incomplete list. Microsoft has acknowledged 
some differences in behavior in network enumeration on Win95 and 
NT. See, for example, Microsoft KnowledgeBase article Q152823, 
“WNetEnumResource Returns Different Info on Win95 and NT.” 
However, even using the information in this article, I could not get 
Win95 to behave correctly. 

Win95 Network Providers 

The workaround that I use for this Win95 problem is to scan 
the registry for the installed network providers, and manually cre¬ 
ate NETRESOURCE structures for them. See the 
EnumerateNetworkWTn95Root( ) and EnumerateWin95NetProviders() 
functions in netnode. cpp (Listing 2) for the implementation of this 
workaround. Briefly, the Win95 registry stores network provider 
information as follows. 

A list of network provider “service names” is stored at the key: 

\HKEY_LOCAL_MACHINE 

\System 

\CurrentControlSet 

\control 

\NetworkProvider 
\0rder 

At this key are a set of values whose names are the network provider 
“service names” (for example. “MSNP32” for Microsoft and 
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“NWNP32” for NetWare). Note that it is the registry value names, 
not the registry value data, which contain this information. 

Each <servi cename) found above has a corresponding registry key: 

\HKEY_LOCAL_MACHINE 

\System 

\CurrentControlSet 

\Services 

\<$ervicename> 

\NetworkProvider 

At this key is a value called “Name” which contains the actual 
provider name (for example, “Microsoft Network” for Microsoft, 
and “NetWare” for NetWare). 

Although cumbersome, this registry query technique seems to be 
fairly safe because these entries are documented in the Win95 
Resource Kit. A similar technique could also be used for Windows 
NT, but the registry format is slightly different. Fortunately, this 
workaround is only necessary for Win95. 

Network Browser Demonstration 

I created the demonstration program in Figure 1 to show how to 
use the CNetNode class in a typical application. NetBrowse is a sim¬ 
ple dialog-based MFC application (MFC is required for the demo 
program, but CNetNode does not rely on MFC); the shell code was 
generated using the Visual C++ AppWizard. 

The left half of the dialog is a standard tree control. Each text 
label in the tree control represents a treeview item stored in a 
TV_ITEM structure. In the structure’s 1 Param field, I store a pointer to 
the CNetNode object represented by that particular item in the tree. 
The right half of the dialog contains a set of edit controls to display 
the properties of the currently selected object. 




SDK Annotation #169 


TYPE: Win32 

TOPIC: TranslateMessage 

KEYWORD: TranslateMessage 


Though the documentation mentions that it 
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actually returns TRUE for all WM_KEYDOWN, 
WM_KEYUP, WM_SYSKEYDOWN and 
WM_SYSKEYUP messages. This behaviour is 
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Reference: MSDN KB Q137231 
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I 


TZ 



There are a few message handler routines of interest in the dia¬ 
log code (see Figure 2, which is an excerpt from the demo pro¬ 
gram). The root node of the tree is created in CreateRootNodeC) 
(called from Onlni tDi al og( )) and destroyed in DestroyWindow(). 
In OnItemexpandingTree( ), I do the following: 

1. First, I check what action the user is performing. If the user has 
clicked on the little “+” sign next to the label, or has double¬ 
clicked on a label that is not currently expanded, then that user is 
expanding a node and I need to enumerate the child nodes and 
add them to the tree. If the user is not expanding a node of the 
tree, I just return. Also, I return if the node has already been 
expanded at least once. If the node has been expanded before, 
then I already have the necessary information because 
NetBrowse does not currently attempt to refresh the tree over 
time. For example, if a new computer or workgroup comes online 
while you are running NetBrowse, you won’t see it — you’ll have 
to exit and restart NetBrowse. The refresh code is not difficult to 
add, but I left it out in the interest of simplicity. 


Figure 2: Using CNetNode to enumerate the network 


II Excerpt from browsdlg.cpp (the full listing is 
// available on this month's code disk) 

void CNetbrowsDlg::CreateRootNode() 

{ 

// Create the root network node (use default constructor) 
m_pRootNode - new CNetNode; 

// Add root node to tree 
AddNodeToTree(m_pRootNode, TVI_R00T); 

UpdateDisplay(NULL); 

1 

void CNetbrowsDlg;:AddNodeToTree(CNetNode *pNode, 

HTREEITEM parent) 

I 

TVJNSERTSTRUCT tvlns -{01; 

tvIns.hParent - parent; 
tvlns.hInsertAfter - TVLSORT; 

tvlns.item.mask - TV IF_TEXT | TVIF_CHILDREN | TVIF_PARAM; 

// It is safe to cast away the const-ness here because 
// we do not allow the tree labels to be edited 
tvlns.item.pszText - 

(char *) ((const char *)pNode->GetText()); 

if (pNode->IsContainer()) 
tvlns.item.cChildren - 1; 
tvlns.item.1Param - (LPARAM) pNode; 

HTREEITEM hltem - m_tree.InsertltemUtvIns); 

1 

void CNetbrowsDlg::OnItemexpandingTree(NMHDR* pNMHDR, 
LRESULT* pResult) 

1 

NMJREEVIEW* pNMTreeView - (NM_TREEVIEW*)pNMHDR; 

LPTVJTEM pParent - &pNMTreeView->itemNew; 

// Assume we will return FALSE, 

// allowing the expansion to occur 
‘pResult - FALSE; 

// If the action is NOT expand, or if we have 
// already expanded at least once, we don't need 
// to do anything here 
if ( pNMTreeView->action !- TVE_EXPAND || 

(pParent->state & TVISJXPANDEDONCE) ) 
return; 

// Get a handle to the parent item 
TV_ITEM tvltem; 
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2. 1 call EnumerateNetwork( ) on the current node (displaying an 
hourglass cursor, since this can be a lengthy process). If an error 
is returned, I display a message box. Otherwise, I call 
CNetNode: :GetChildCount( ) to obtain the number of child 
nodes. 

3. If there are one or more child nodes, I use AddNodeToTree( ) to 
add each child node to the tree. I call CNetNode:: IsContainer() 
to determine if the new node being added is a container (a node is 
capable of having child nodes). For example, a computer is a con¬ 
tainer because it can have child nodes such as shared directories or 
printers. In contrast, a printer is not a container because it cannot 
contain any other network resources. At this point, I know only if 
the node is capable of having child nodes, not if it actually has any. 
So 1 set the cChildren member in the 


Conclusion 

If you are not a networking expert, the concepts discussed here 
may seem complex at first. Fortunately, one of the great virtues of 
C++ — and of object-oriented programming in general — is the 
ability to encapsulate at least some of that complexity. You can use 
the CNetNode class and the other code from this article as is, or 
extend it in ways appropriate to your own needs. In any case, the 
information presented here should help you to implement network 
browsing in your own applications. □ 

[Download the code from WIVIV. Wdj.C0m/ SOUrce.htm.] 


TV_ITEM structure to 1 to force a “+” sign 
to be displayed next to the item. 

4. If there are no child nodes, I remove the 
“+” sign from the parent item by setting 
the cChildren member in the TV_ITEM 
structure to 0 and updating the item. 

In OnSelchangedTree( ), I call the 
“Get...” member functions for the currently 
selected CNetNode object and update the 
edit controls with the node’s properties. The 
numeric properties are translated into text to 
make them more meaningful (for example, 
a resource type of disk is displayed as 
“DISK” instead of a numeric code). 


Notice 

To Our Subscribers 

Occasionally, Windows Developer's 
Journal makes its mailing list 
available to vendors of products 
we think our readers will find 
interesting. Current subscribers 
receive free information in the 
mail from these vendors. 

If you prefer that your name not 
be used in these mailings, please 
let us know. Just copy or clip this 
form and send it with your name 
and address to: 

Windows 

The Magazine for Windows Programmers 

P.O. Box 56565 
Boulder, CO 80322 






-lint 


for C/C++ 
Version 7.0 

presents Bug # 514 



This program to process pizza orders attempts to record whenever a meatless pizza is 
ordered. But it doesn ’t seem to be working. Why not? Call if you need a hint, or refer to 
our web page at http: / /www. gimpel .com. 


PC-lint for C/C++ will catch this and many 
other bugs. It will analyze a mixed suite of C 
and C++ modules to uncover bugs, glitches, 
quirks and inconsistencies. 

Version 7 of PC-lint breaks new ground with 
inter-statement value tracking for both 
automatic variables and class data members. 
Taking clues from assignment statements, 
initializers and conditional expressions it can 
detect out-of-bound subscripts and potential 
null pointer uses. As an enabling technology, 
almost 100 standard functions are rigorously 
checked. Also macros are subject to increased 
scrutiny, checking for unparenthesized 
parameters, unparenthesized bodies and 
repeated arguments having side-effects. 

Plus Our Traditional C/C++ Warnings: 
Uninitialized variables, inherited non-virtual 
destructors, strong type mismatches, 


inadvertent name-hiding, suspicious 
expressions, etc., etc. 

Full C++ Support - PC-lint for C/C++ 
is based on the ARM and is tracking the 
latest ANSI/ISO draft including exceptions 
and templates. It supports both Borland and 
Microsoft C/C++. 

PC-lint for C/C++ $239 

Numerous compilers/ libraries supported. 
Runs on MS-DOS (Optional built-in 386 
DOS extender), OS/2, NT and Windows 95. 
This price is subject to increase. 

FlexeLintfor C/C+ + 

The same great product for other operating 
systems. Runs on all Unix systems, VMS, 
mainframes, etc. Distributed in shrouded 
C source form. Call for pricing. 


PA add 6% sales tax. 


<2itap<sl SoUwars 

3207 Hogarth Lane, Collegeville, PA 19426 

CALL TODAY (610)584-4261 Or FAX (610)584-4266 

30 Day Money-back Guarantee. 

PC-lint and FlexeLint are trademarks of Gimpel Software 


February 1997 


• windows developer’s journal • www.wdj.com • 


59 












Figure 2: continued 

mJocalName - pNode->GetLocalNamed; 
m_remoteName - pNode->GetRemoteName(); 

• tvltem.hltem - pParent-Ahltem; 

m_comment - pNode->GetComment( ) ; 

,• tvltem.mask - TVIF_HANDLE ; 
m_tree.GetItem(&tvItem) ; 

m_provider - pNode->GetProvider(); 

// Get numeric items from net node 

// We are expanding an item for the first time 

DWORD scope - pNode->GetScope( ) ; 

// Enumerate its children and add them to the tree 

DWORD type - pNode->GetType(); 

DWORD numChi1dren - 0; 

DWORD displayType - pNode->GetDisplayType(); 

DWORD ret - 0; 

DWORD usage - pNode->GetUsage(); 

CNetNode * pPa rentNode - (CNetNode *) pParent->lPa ram ; 

// Convert numeric codes to text for display 

if (scope =■ RESOURCE_CONNECTED) 

/ { 

m scope - "CONNECTED"; 

CWaitCursor wc; // display hourglass cursor 

else if (scope -- RESOURCE_GLOBALNET ) 

ret - pParentNode->EnumerateNetwork(); 

m scope - "GLOBALNET"; 

} 

else if (scope — RESOURCE REMEMBERED) 
m scope - "REMEMBERED"; 

if (ret) 

#1f(HINVER >- 0x0400) 

1 { 

else if (scope — RESOURCE_RECENT) 

static const DWORD maxMsgLen - 1024; 

m_scope - "RECENT"; 

CString errMsg; 

else if (scope == RESOURCE_CONTEXT) 

char * pMsgBuf - errMsg.GetBuffer(maxMsgLen) ; 

DWORD formatRet - FormatMessaget 

m scope - "CONTEXT"; 

#endif // WINVER >- 0x0400 

FORMAT MESSAGE IGNORE INSERTS | 

if (type -- RESOURCETYPE UNKNOWN) 

FORMAT_MESSAGE_FROM_SYSTEM, 

m_type - "UNKNOWN"; 

NULL, ret, 0, pMsgBuf, maxMsgLen, NULL); 

else 

{ 

m type - 

if (type 4 RESOURCETYPEJNY) 

errMsg.ReleaseBufferO; 

if (formatRet — 0) 

m type +- "ANY "; 

errMsg.FormatC'Network enumeration failed. \n\n" 

if (type 4 RESOURCETYPEJISK) 

''Error code: *lu.", ret); 

m type +- "DISK "; 
if (type & RESOURCETYPE_PRINT) 

MessageBox(errMsg, "Error", 

m_type +- "PRINT "; 

MB ICONEXCLAMATION | MB OK); 

1 ) 
else 

} 

if (displayType — RESOURCEDISPLAYTYPE_GENERIC) 

1 t 

m displayType - "GENERIC"; 

CNetNode * pChildNode; 

else if (displayType — RESOURCEDISPLAYTYPEJOMAIN) 

numChildren - pParentNode->GetChildCount(); 

m_displayType - "DOMAIN"; 

else if (displayType -- RE$OURCEDISPLAYTYPE_SERVER) 

for (DWORD i - 0; i < numChildren; i++) 

m_displayType - "SERVER"; 

I { 

else if (displayType -- RESOURCEDISPLAYTYPE_SHARE) 

pChildNode - pParentNode->GetChildNode(i); 

m_displayType - "SHARE"; 

AddNodeToTreetpChildNode, tvltem.hltem); 

1 ) 

else if (displayType -- RESOURCEDISPLAYTYPE_FILE) 

m_displayType - "FILE"; 

| } 

else if (displayType — RESOURCEDISPLAYTYPE_GROUP) 
m displayType - "GROUP"; 

| // If there are no child items, or an error occurred. 

#if(WINVER >- 0x0400) 

| // remove the "+" from the parent item by indicating 

else if (displayType — RESOURCEDISPLAYTYPE_NETWORK) 

// it has no child items 

m_displayType - "NETWORK"; 

if (ret || numChildren — 0) 

else if (displayType — RESOURCEDISPLAYTYPE_ROOT) 

| { 

m_displayType - "ROOT"; 

tvltem.mask |- TVIF_CHILDREN; 

else if (displayType -- RESOURCEDI$PLAYTYPE_SHAREADMIN) 

tvltem.cChildren - 0; 

m_displayType - "SHAREADMIN"; 

m_tree.Setltem(&tvltem); 

else if (displayType -- RESOURCEDISPLAYTYPE_DIRECTORY) 
m displayType - "DIRECTORY"; 

// indicate that tree expansion should NOT occur 

#endif /* WINVER >- 0x0400 */ 

*pResult - TRUE; 

else if (displayType -- RESOURCEDISPLAYTYPE_TREE ) 

I } 

! } 

m_displayType - "TREE"; 

m usage - 

void CNetbrowsDlg::OnSelchangedTree(NMHDR* pNMHDR, 

#if(WINVER >- 0x0400) 

LRESULT* pResult) 

1 { 

if ((usage 4 RESOURCEUSAGE_ALL) — RESOURCEUSAGE_ALL) 

m_usage +- "ALL "; 

NM_TREEVIEW* pNMTreeView - ( NM_TREEVIEW* ) pNMHDR ; 

el se 

LPTVJTEM pNewItem - &pNMTreeView->itemNew; 

#endif 

UpdateDisplay ( pNewItem) ; 

{ 

*pResult - 0; 

if (usage 4 RESOURCEUSAGE CONNECTABLE) 

i} 

m usage +- "CONNECTABLE "; 
if (usage 4 RESOURCEUSAGEJONTAINER) 

void CNetbrowsDlg::UpdateDisplay(LPTV ITEM pltem) 

i { 

CNetNode * pNode; 

m usage +- "CONTAINER "; 

} 

if (usage 4 RESOURCEUSAGE NOLOCALDEVICE) 

if (pltem -- NULL) 

mjjsage +- "NOLOCALDEVICE "; 

pNode - m_pRootNode; 

if (usage 4 RESOURCEUSAGE_SIBLING) 

else 

I pNode - (CNetNode *) pltem->lParam; 

m_usage +- "SIBLING "; 

UpdateData(FALSE); // copy member variables to screen 

// Get text items from net node 

1 


//End of File 
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Paula Tomlinson 

Understanding NT 



In this month’s column I will return to the topic of services again 
to answer several reader questions. In particular, I will examine 
whether or not interactive services can display a user interface 
before a user has logged on. I’ll also revisit the problems with call¬ 
ing MessageBox( ) from a service. 

Pre-Logon Interactive Services 

Can a service (or app) run w/GUI before a user logs in? My 
client is worried about power failure/reboot at midnight and the app 
not running until someone logs in at 8 am. Any thoughts? 

Jason Williams 

This question consists of several parts. First, for a process to run 
before a user logs on, it really needs to be a service (or at least a 
process that is started by a service). Services are started by the ser¬ 
vice controller based on a start attribute that can be assigned pro¬ 
grammatically in the call to CreateServi ce (), or by a user modify¬ 
ing the Startup parameters in the Services control panel applet. If 
you want the service to be automatically started when the system 
boots, pass the SERVICE_AUTO_START flag to CreateService() 
when the service is installed. Auto-start services will almost always 
be started by the operating system before a user logs on. Notice that 
I said “almost always.” It’s dangerous to assume that an auto-start 
service will always start before a user logs on. While it’s true that 
the service controller will not wait for a user to log on before it 
begins loading auto-start services, you cannot assume that a given 
service will have started before logon. On a system with many auto¬ 
start services (each taking up to 30 seconds to initialize), a speedy 
user might be able to log on before all the auto-start services have a 
chance to load. Auto-start services must be prepared for the fact that 
a user may or may not have logged on before the service is started. 

The previous statements apply to interactive services as well as 
non-interactive services. First, I’ll review what an “interactive” ser¬ 
vice really is. The term “interactive” usually implies that the service 
can interact with the user via user interface objects such as dialog 
boxes and windows. In order to be interactive, a service must run 
under the LocalSystem account and must be marked as 
SERVICE_INTERACTIVE_PROCESS (either programmatically via 
CreateServi ce () or by selecting “Allow Service to Interact with 
Desktop” in the Services control panel applet). Being an interactive 
service, however, implies more than just the ability to call 

mmttM 

g Borland v5.01 
Visual C++ v4.1 

Paula Tomlinson has been developing DOS, Windows and Windows-NT based 
applications and device drivers for nine years. The opinions expressed here are 
hers alone. She can be contacted via the internet at paulat@microsoft.com. 


DialogBox() and CreateWi ndow(). You need access to the applica¬ 
tion desktop (and the interactive window station that owns that desk¬ 
top) to call most Win32 user interface functions. But aren’t the appli¬ 
cation desktop and interactive window station created after a user 
logs on? If so, how can interactive services run before a user logs on? 

Actually, if your service enumerated all the window stations and 
desktops available when it first loaded (assuming no one has logged on 
yet), you would find that the application window station (currently 
called “WinStaO”) and the default desktop (currently called “Default”) 
are created before logon. The existence of the application desktop 
doesn’t necessarily mean that it’s the active desktop, though. When a 
process attempts to create a window, that window will be “displayed” 
on the desktop associated with that process. If the associated desktop is 
not the active desktop, then the window won’t be visible. Note that 
through version 4.0, Windows NT allows only one interactive window 
station, so the window station will almost always be “WinStaO.” This 
may change in later versions of the operating system. 

To demonstrate how this works, I wrote the skeleton service in 
wd j s rvc. C (Listing 1); the associated header file is wd j S rvc. h (Listing 
2) and the dialog definition is in wd j S rvc. rc (Listing 3). I installed this 
as an interactive, auto-start service running under the LocalSystem 
account on a system. When the operating system boots, the service 
controller attempts to start the WDJSrvc service since it’s marked as 
auto-start. At this point, it doesn’t really matter whether my service is 
interactive or not. My mail'd) routine is called and I register my 
ServiceMainO routine with the service controller by calling 
StartServi ceCtrl Dispatcher(). The service controller then calls 
my Servi ceMa i n (). My goal is for this service to display a dialog box 
when it first loads. There are two issues associated with how I make 
the call to Dial ogBox(). The first issue deals with where in the service 
initialization process I make the call to DialogBox(), and the second 
issue (as I alluded to above) deals with the active desktop. 

If you’re going to display any modal user interface objects (such 
as modal dialog boxes or message boxes) during service startup, 
you should avoid doing so during the time-critical period between 
when Servi ceMai n () is called and when your service tells the ser¬ 
vice controller that it’s running. The service controller will not wait 
forever before it decides the service has died. You have only 30 sec¬ 
onds to let the service controller know you’re running, so you can’t 
wait for user input here. In my example, another constraint is that I 
want to treat the failure to create the services’s main worker thread 
as a fatal error. To meet the second constraint, I wait until the thread 
is created before reporting to the service controller that I’m running. 
To meet the first constraint, I place the call to Di al ogBox() in the 
service’s main worker thread. This lets the call to Dial ogBox() 
occur very shortly after the service is loaded but doesn’t get in the 
way of reporting back to the service controller. You report your ser¬ 
vice status to the service controller by calling SetServi ceStatus (). 
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In wdjsrvc.c (Listing 1), I’ve wrapped the call to 
SetServi ceStatus () with the private NotifySCMO routine. 

Now, assume that my service initialization occurs before a user 
logs on. Before logon, while the system is displaying the logon 
prompt, the active window station is “WinStaObut the active desk¬ 
top is “Winlogon.” By default, my service (since it runs under the 
LocalSystem account and is interactive) is associated with the 
“WinStaO” window station and the “Default” desktop. Since the ser¬ 
vice’s desktop is not the active desktop, the call to DialogBox() 


doesn’t necessarily fail, but the dialog box will not be visible. Because 
the dialog box isn’t visible, a user can’t interact with it or dismiss it, so 
the call to Di a 1 ogBox() essentially waits until the active desktop is the 
“Default” desktop. This happens after a user logs on. And to make 
things even more complicated, remember that just because a user has 
logged on does not mean that the application desktop (“Default”) is 
active. The screen saver desktop, for instance, could be active. 

So, the call to Dial ogBox () doesn’t return until a user logs on (and 
the interactive desktop is still active) and a user dismisses the dialog 


Listing 1: wdjsrvc.c — An interactive pre-logon 


j // wdjsrvc.c 

: #inetude <windows.h> 

#inet ude <std1o.h> 

' #1 net ude "wdjsrvc.h" 

// private prototypes 

BOOL NotifySCM(DWORD, DWORD, DWORD); 

VOID WINAFI ServiceMain(DWORD, LPTSTR *); 

VOID WINAPI ServiceHandler(DWORD); 

DWORD WINAPI MainServiceThreadlLPDWORD); 

BOOL CALLBACK ServiceDlgProc(HWND. UINT. WPARAM, LPARAM); 

HANDLE hDoneEvent - NULL, hThread - NULL; 

DWORD dwCurrentState; 

SERVICE_STATUS_HANDLE hService; 

//. 

void main(void) 

1 

$ERVICE_TABLE_ENTRY ServiceTabte[] - { 

{TEXT("WDJSrvc"), (LPSERVICE_MAIN_FUNCTION)Servi ceMain>, 
{NULL, NULL) 


// connect to the service control manager 
StartServiceCtrlDispatcher!ServiceTable); 


case SERVICE_C0NTR0L_ST0P: 

NotifySCM(SERVICE_ST0P_PENDING, 0, 1); 
SetEvent(hDoneEvent); 

NotifySCM(SERVICE_ST0PPED, 0, 0); 
break; 

case SERVICE_C0NTR0L_INTERROGATE: 

NotifySCMCdwCurrentState, 0, 0); 
break; 

case SERVICE_C0NTR0L_SHUTD0WN: 
break; 


//. . 

BOOL NotifySCMCDWORD dwState, DWORD dwWin32ExitCode, DWORD dwProgress) 

1 

SERVICE-STATUS Servi ceStatus; 

ServiceStatus.dwServiceType - SERVICE_WIN32_0WN_PR0CESS: 

ServiceStatus.dwCurrentState - dwCurrentState - dwState; 
ServiceStatus.dwControlsAccepted - SERVICE_ACCEPT_ST0P | 
SERVICE_ACCEPT_SHUTDOWN; 

Servi ceStatus.dwWi n32ExitCode - dwWin32ExitCode; 

ServiceStatus.dwServiceSpecificExitCode - 0; 

Servi ceStatus.dwCheckPoint - dwProgress; 

ServiceStatus.dwWaitHint - 5000; 

return SetServiceStatus(hService, &ServiceStatus); 


| //.— . 

#1fdef _BORLANDC_ 

# pragma argsused 
#end1f 

VOID WINAPI Servi ceMain(DWORD dwArgc, LPTSTR *1 pszArgv) 

: { 

DWORD Threadld; 

if (0 -- (hService - RegisterSem'ceCtrlHandler(TEXT("WDJSrvc”) 
(LPHANDLER_FUNCTI0NJServiceHandier))) { 
return; 

) 

NotifySCMfSERVICE_START_PENDING, 0, 1); 

if (0 — (hDoneEvent - CreateEvent(NULL, FALSE, FALSE, NULL))) 
return; 

} 

NotifySCM(SERVICE_START_PENDING. 0, 2); 

if (0 — (hThread - CreateThread(0, 0, 

(LPTHREAD_START_R0UTINE)MainServiceThread, 0, 0, 
SThreadld))) { 

Cl oseHandl e(hDoneEvent); 
return; 

} 

NotifySCM(SERVICE-RUNNING, 0, 0); 

WaitForSingleObjectfhDoneEvent, INFINITE); 

CloseHandle(hThread); 

CloseHandle(hDoneEvent); 

return; 


j //. . 

VOID WINAPI ServiceHandlerCDWORD fdwControl) 

1 

switch(fdwControl) { 


//. 

#1fdef _BORLANDC_ 

# pragma argsused 
ifendif 

DWORD WINAPI MainServiceThread(LPDWORD ThreadParam) 

1 

OutputDebugString(WDJSRVC: In MainServiceThread\n"); 

DialogBox(GetModuleHandle(NULL), 

MAKEINTRESOURCE(SERVICE_DIAL0G), NULL, ServiceDlgProc) 

OutputDebugStringC--> WDJSRVC: Dial ogBox closed\n"); 

while (TRUE) { 

// 

// this is where the service would actually do something 
II 

Sleep(lOOOO); 

) 

return TRUE; 


II . 

#1fdef _BORLANDC_ 

# pragma argsused 
#endif 

BOOL CALLBACK ServiceDlgProctHWND hDlg, UINT msg, 
WPARAM wParam, LPARAM IParam) 

{ 

switch (msg) { 
case WM.COMMAND: 

switch(LOWORO(wParam)) { 
case IDOK: 

EndOialog(hDlg, TRUE); 
return TRUE; 

} 

break; 

) 

return FALSE; 

} 

//End of File 
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box. In some cases, this may be exactly the behavior you want. The 
service may not be required to perform any tasks until a user has made 
some selections. But if you want your auto-start service to start work¬ 
ing immediately after it’s started, as in Jason’s case, then don’t put any 
calls to MessageBoxO or Dial ogBox () in the main code path. Any 
calls to MessageBoxO or DialogBoxO may end up spinning until a 
user logs on or the screen saver stops running. The simplest solution is 
probably just to put these calls in a separate thread. 

On the other hand, if you really need the dialog box to appear 
whether or not a user has logged on and irregardless of the active 
desktop, then you need to do a little bit more work. In Figure 1, I 
provided a slightly modified version of my service’s main worker 
thread routine. This time, before the call to Dial ogBox (), I retrieve 
a handle to the desktop that is currently associated with my worker 
thread (and process) by calling GetThreadDesktop (). I need to 
hang onto the current desktop handle so that I can restore it later. 
Next, I retrieve a handle to the current input desktop (this is the 
active desktop) by calling OpenlnputDesktopf ). Finally, I assign 
the current input desktop to my thread by calling 
SetThreadDesktopt ). Now my thread is associated with whichever 
desktop happens to be the input desktop and my call to 
Dial ogBox( ) produces a visible dialog box. In this case, since a user 
hasn’t logged on yet, the input desktop is “Winlogon” and my dia¬ 
log box appears right next to the logon prompt dialog box (see 
Figure 2). When the Dial ogBox( ) call returns, I reset the thread’s 
desktop back to its original value by calling SetThreadDesktop(). 

There’s just one more issue. Even though my dialog box is visi¬ 
ble for the moment, any number of things can change that. A user 


can log on, causing NT to switch the input desktop to the “Default” 
desktop. A screen saver could start running, which would also 
change the input desktop. If you really need the dialog box to 
remain active and visible at all times, you will probably need to poll 
to determine the active desktop at any given time. 

In summary, remember that services should not assume that they 
start either before or after a user logs on. A very fast user can possi¬ 
bly log on before the last services have had a chance to start. 
Services should also not assume that just because a user has logged 
on, the default desktop is active. The most common scenarios where 
a different desktop is active would be when the workstation is 


Listing 2: wdjsrvc.h — Header file for sample service 


// wdjsrvc.h 

#define SERVICE.DIALOG 1000 
//End of File 


Listing 3: wdjsrvc.rc — Dialog for sample service 


#if !defined(W0RKSH0P_INVOKED) 

# include <windows.h> 
jfendif 

i/include "wdjsrvc.h" 

SERVICE.DIALOG DIALOG 150, 200, 160, 64 
LANGUAGE LANG.ENGLISH, SUBLANG.ENGLISHJS 

STYLE DS.MODALFRAME | WS.POPUP | HSJISIBLE | WS.CAPTION | WS_SYSMENU 
CAPTION "WdjSrvc" 

FONT 8, "MS Shell Dig" 

BEGIN 

LTEXT "UI from an Interactive Service”,-1,20,12,120,8 
PUSHBUTTON "OK",ID0K.100.40,40,14 
END 
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locked, a screen saver is running, or some other desktop (created 
by another program) is active. Also, the fact that service has the 
S ERVIC E_I NTERACTIV E_P ROC ESS flag does not guarantee that the 
service will be allowed to interact with the user. A user can override 
the SERVICE_I NTERACTIVE_PR0CESS flag on individual services via 
the Services control panel applet and on all services by setting the 
“NoInteractiveServices” value to 1 under the 

HKEY_LOCAL_MACHINE 
\System 

\CurrentControlSet 

\Control 

\Windows 

key in the registry. 

MB_SERVICE_NOTIFICATION Revisited 

In your June 1996 “Understanding NT" (page 52), you said “I 
did verify that the beta version of Windows NT 4.0 is capable of 
handling both the old (0x00040000) and the new (0x00200000) def¬ 
initions o/MB_SERVICE_N0TI FI CAT ION.” I think this has changed in 
the NT 4.0 release code. We implemented an internal wrapper to 
Hess a g eBox (), which made the above assumption (and simply used 
the old definition of the bit), and it suddenly stopped working when 
the NT 4.0 release code was installed in our test lab. So I changed 
the code to check the OS version first, and use one bit or the other 
appropriately. Works fine now. Just thought I would point that out in 
case you want to mention it in a future column. 

Tim Farley 
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I want to thank Tim for pointing this out. To refresh your mem¬ 
ory, the MB_SERV I CE_N0TI FI CAT ION flag is used when non-interac¬ 
tive services need to call MessageBox( ). Up through NT version 
3.51, MB_S ERV I CE_N0T IFI CAT ION was defined as 0x00040000L but 
was changed to 0x00200000 L in NT 4.0 (to avoid a conflict with a 
new MessageBoxO flag defined by Windows 95). winuser.h (in 
the official SDK for Windows NT 4.0) now defines 
MS_SERVICE_N0TI FICATI0N as follows: 

#i fdef _WIN32_WINNT 

#if (_WIN32_WINNT >= 0x0400) 

((define MB_SERVICE_N0TIFICATI0N Ox00200000L 

((el se 

((define MB_SERVICE_N0TIFICATI0N 0x000400001 

((endif 

((define MB_SERVICEJ0TIFICATI0N_NT3X 0x00040000L 
((endif 

The bottom line is, Windows NT 4.0 only recognizes the value 
0x002000001. as meaning MB_S E R VIC E_N0T IFI CAT I ON, and 
Windows NT 3.51 (and earlier) only recognizes Ox00040000L as 
meaning MB_SERVICE_N0TIFICATI0N. Your safest bet now is proba¬ 
bly to just use the latest version of winuser.h and wrap your 
Mess a geBox () calls with the function in Figure 3. 

BackOffice Logo Requirements 

I have searched about 6 MSDNs and BO SDKs for the 
BackOffice logo requirements you mentioned in the October 1996 
issue of WDJ. If you could point me to the correct volume I would 
appreciate it! Thanks for the continuing excellent articles, always 
very timely as I plow my way. 

David Wilkison 


In the October 1996 installment of the “Understanding NT” col¬ 
umn, I mentioned that Microsoft recommends separating user 


Figure 1: Displaying the dialog before logon 


DWORD WINAPI MainServiceThread(LPDW0RD ThreadParam) 

{ 

HDESK hDesktop, hOldDesktop; 

OutputDebugString(> WDJSRVC: In MainServiceThreadW); 

II 

II Save process’s current desktop then get a handle to the 
// current input desktop and switch to it. 

II 

hOldDesktop - GetThreadDesktop(GetCurrentThreadldO); 
hDesktop - OpenlnputDesktoptO, FALSE, DESKT0P_CREATEWIND0W); 
SetThreadDesktopthDesktop); 

DialogBoxtGetModuleHandle(NULL). 

MAKEINTRES0URCE(SERVICE_DIAL0G), NULL, ServiceDlgProc); 

II 

II Restore the original process's desktop. 

II 

SetThreadDesktopthOldDesktop); 

OutputDebugString(”--> WDJSRVC: DialogBox closedin"); 

while (TRUE) { 

II 

II this is where the service would actually do something 
II 

Sleep(lOOOO); 

) 

return TRUE; 

) 

//End of File 
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interface functionality from the service code as part of the 
BackOffice Logo program. These documents are somewhat buried in 
the MSDN Library (and perhaps in other locations as well). In the 
October 1996 MSDN Library, you will find some of the general 
BackOffice licensing forms under Specifications Windows 
Guidelines - ISV Logo Requirements. The technical requirements 
and recommendations can be found under Product Documentation 
- SDKs - Microsoft BackOffice SDK - Microsoft BackOffice 
Programmer’s Reference - Programming Requirements and 
Recommendati ons. In particular, peruse the section discussing server 
requirements (as opposed to client requirements). The references to 
separating the user interface from the service are sprinkled around, 
making them difficult to find. One example, however, is the follow¬ 
ing statement under Supporting Remote Administration: “Create a 
separate user interface (UI) client portion that communicates to a 
server portion by way of remote procedure call.” Once again, this is 
currently a “recommendation” and not a “requirement” for the 
BackOffice logo. Microsoft also seems to be pushing this message at 
recent developer events such as conferences and seminars. 

References 

Tomlinson, Paula. “Understanding NT,” Windows Developer’s 

Journal , June 1996 and October 1996. □ 

[Download the code from WWW. wdj.com/source.htm.] 



Figure 2: 

■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■ 

The sample service in action 

Figure 3: 

A wrapper function for MessageBoxQ 


int MyMessageBoxdPTSTR Text, LPTSTR Caption, UINT Type) 
{ 


OSVERSIONINFO Ver; 

Ver.dwOSVersionlnfoSize - sizeof(OSVERSIONINFO); 
GetVersionEx(&Ver); 

if (Ver.dwMajorVersion <- 3) { 

Type |- MB_SERVICE_N0TI FICATI0N_NT3X; 

1 else { 

Type |- MBJERVICEJ0T1FICATI0N; 

1 

return MessageBoxtNULL, Text, Caption, Type): 

1 

// End of File 
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communication programs from your application. CrystalCOMM is a 
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First Impressions of Recent Titles 


Ron Burk 

Books in 


About Face: The Essentials of User Interface Design 

Alan Cooper 

580 pages 

IDG Books, 1995 

$29.99 

ISBN 1-56884-322-4 

I avoided this book for a long time. The preliminary press on it 
was so effusive (“Alan Cooper is a software god . . .”, “Alan 
Cooper’s mind harbors a deep, compelling model of software- 
human interaction . . .”, and so on), that I figured it just had to be a 
stinker. The problem with user interface design books is that nearly 
all of them ignore the details of the most widespread operating sys¬ 
tem on the planet: Windows. That’s especially depressing for 
Windows programmers, since Windows offers a lot more GUI prob¬ 
lems to solve than do many other operating systems; Microsoft 
tends to solve GUI problems first in Word and Excel, eventually 
migrating slightly shabby clones of those solutions into the operat¬ 
ing system. My bookshelf didn’t need another high-level treatise on 
user interface design — I can already recite their trite mantras by 
heart: don't use culturally loaded icons, keep dialogs simple and 
clean, avoid confusing error messages, and so on. 

On the other hand, studying Windows user interface design is a 
hobby of mine, and I kept seeing this book at the bookstore, so I final¬ 
ly broke down and bought a copy. A few months later, I actually 
opened it and started reading. What a surprise! You can’t tell it from 
the title, but this book is devoted mostly to Windows user interface 
issues. Most of the example screen shots are taken from familiar ver¬ 
sions of Windows or well-known Windows applications. It does stay 
fairly abstract, avoiding any explicit contact with the Windows API 
and implementation details, but I had to admit the author was talking 
about issues I cared about — issues I haven’t seen covered in any 
breadth or depth in other books. Fundamental issues such as how the 
mechanisms of selection, drag-and-drop, and menus should work are 
discussed. Though you can take the existing conventions and imple¬ 
mentations of these techniques for granted, thinking about them in 
detail is worthwhile if you really care about your user interface. 

Although the discussions in this book are not at the API level, 
they clearly hit topics that non-programmers are less likely to think 
about. Thus, toolbars are not good just because they can be intuitive 




Got an opinion about these or other programming books? Send them to 
70302.2566@compuserve.com. You can order any of the books that appear 
in Books in Brief from Miller Freeman, Inc. by calling (913) 841-1631. faxing 
(913) 841-2624, or sending email to orders@mfi.com. If using fax or email, 
send the book title, author, and publisher along with your MasterCard, Visa, 
or American Express number ; expiration date, and phone number. 

To submit books for review, send them to: Ron Burk, 13846 NE 60th Way, If 120, 
Redmond, WA 98052-4542. Please do not send press releases to this address. 


to use, but also because they pack a lot of functionality into few pix¬ 
els; if your software has to support screens down to VGA mode, con¬ 
serving pixels becomes crucial. It’s also useful to see arguments 
against specific techniques that Microsoft encourages. For example, 
once you’ve been writing Windows programs for a few years, it’s 
hard to remember back to when you were a “real user,” and were irri¬ 
tated by things like the fact that “About boxes” don’t actually tell you 
anything useful about the program you’re using. In general, the 
author provides detailed arguments for making the user interface 
work a particular way, and keeps unexplained missives (e.g., “Dialog 
buttons should always be at least 7 pixels apart”) to a minimum. 

My main complaint with this book is that I wanted it to discuss 
more topics, and in more depth. The 580 pages would cook down to 
perhaps 300 pages if it had not been formatted specifically to 
achieve a certain bookstore-shelf bulk. It’s still well worth the 
$29.99 (especially compared to what else is out there), but I wanted, 
for example, the chapter on drag-and-drop to address the details of 
OLE 2.x’s uniform data transfer, as well as the specific drag-and- 
drop APIs that the new common controls provide. Realistically, 
though, the level of detail I want might only be salable to perhaps a 
few thousand hard-core programmers — not enough to pay the cost 
of creating such a book. This book does a fairly good job of staying 
abstract and non-technical enough to appeal to a mass market, but 
still concrete enough to be of some use to the relatively few folks 
who actually perform detailed coding of Windows user interfaces. 

I found plenty of ideas here to disagree with (some are com¬ 
pletely insane), but even those were worth reading, since the author 
explains ideas in enough detail that you can usually understand why 
you disagree with him. Mainly, it was a relief to find a book talking 
about user interface design issues that were highly relevant to 
Windows programming. 

Spells of Fury 
Michael J. Norton 
642 pages 

$49.99, includes CD-ROM 
Waite Group Press, 1996 
ISBN 1-57169-067-0 

[Editor's note: this review was 
Dean Hupp.] This is the first book that does an adequate job of cov¬ 
ering the DirectX API. It is not perfect, but certainly the best of 
what is available. I’ll start with the good qualities. 

The book does not use MFC. This is a great bonus, since most 
other DirectX books are MFC-based, making them useless for the 
majority of people wanting to learn DirectX. The author mentions 
that he “decided early on to not use MFC.” If he had, it would have 
ruined the book for me. 
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The only other book available on DirectX that does not use MFC is 
dedicated to covering DirectDraw only. This book, however, covers 
the entire DirectX API. It has separate chapters on DirectDraw, 
Directlnput, DirectSound, and DirectPlay. The author starts each 
chapter by reviewing the historical issues that game developers face, 
and then explains how DirectX attempts to resolve those issues. 
Finally, helper functions are created and then used to write a small 
test game that uses the key functionality presented. I found this 
approach to be very intuitive and straightforward. 

In fact, the author’s presentation was generally above average. In 
many areas, the author presented information that made you feel he 
had “real” experience in game programming. The book contains five 
chapters dedicated to creating individual games. These games focus on 
a single area of game programming: Chapter 8 focuses on Collision 
Detection; Chapter 9 on Tile Maps; Chapter 10 on Network Gaming; 
Chapter 11 on Scrolling Terrain; and Chapter 12 on alternative input 
devices. These focused exercises make the concepts much easier to 
grasp than an all-encompassing game built chapter by chapter. 

This book is the first DirectX book that uses C++ classes in a 
reasonable way. Most of the code was not structured as classes. 
However, whenever it made sense to, the author created a very sim¬ 
ple class to manage certain programming tasks. For example, he 
created a class to manage DIBs, sprites, and lists. Most of the game 
code itself was not class-based. This approach was very logical and 
matches my own coding practices. 

Finally, the author assumes a reasonable level of intelligence. He 
doesn’t include the entire source for each exercise in the book. Key 
functions that are being built are listed, but others are just men¬ 
tioned in passing, if at all. I found this refreshing. I was able to cre¬ 
ate all the helper functions without referring to the included CD. 
This technique really pulled me into the book and gave me a full 
understanding of what was being presented. 

Despite all the good things about the book, it also has its flaws. 
For starters, the book is subtitled “Building Windows 95 Games 
Using DirectX 2.” This is complete fiction — the book is about 
DirectX 1.0 throughout. The primary component of DirectX 2 is 
Direct 3D, and it isn’t even mentioned in the index. Also, one of the 
game exercises creates a 3D game that would have been perfect for 
Direct3D, and Direct3D isn’t used. Putting DirectX 2.0 on the front 
cover of the book is a blatant misrepresentation of what the book cov¬ 
ers. I called Waite Group Press and filed a complaint on this issue. 

The ownership of the software included with the book is — inter¬ 
estingly enough — not yours as the buyer of the book. On page 638, 
in the software license agreement, it clearly says that “The program, 
including the copyrights in each program, is owned by the respective 
author.” I could not find any documentation that clearly stated 
whether or not the code libraries could be reused in personal projects. 

The author had a funny habit of including a short fiction story at 
the beginning of every chapter. Some readers may find this amusing 
or entertaining. I found it to be rather irritating, and systematically 
skipped them. Having read the first one, I really don’t understand 
the relevance. It succeeded in destroying the continuity of the book. 

The book also has the standard 25-page introduction to Windows 
programming in Chapter 1. Need I say more? 

Overall, I recommend this book to anyone wanting to get a grasp 
of DirectX 1.0. It is probably not well suited to an accomplished 
game developer, but is a valuable reference to anyone who writes 
games as a hobby. It also has a very good chapter on DIBs, with 
over 60 pages of coverage. 


CGI Programming in C & Perl 



CGI Programming in C & Perl 
Thomas Boutell 
400 pages 

Addison-Wesley, 1996 
$34.95 

ISBN 0-201-42219-0 


[Editor’s note: this review was provided by 
Victor Volkman.] CGI Programming in C & Perl by Thomas Boutell is 
a well-paced introduction to learning how to develop Common 
Gateway Interface (CGI) applications. CGI is a fancy name for the 
mechanism by which the WWW broswer and server exchange data via 
HTML and assorted environment strings. This allows you, for exam¬ 
ple, to fill out a query form on a Web browser, send the results to the 
Web server, and have the Web server perform various online tasks for 
you (e.g., text search or shopping), and finally return some results. 
CGI programming historically accounts for at least 90 percent of the 
backend Web development that occured before 1996. PERL is an 
interpreted shell scripting language which resembles modem variants 
of BASIC plus some interesting dynamic list management features. 

The author assumes a working knowledge of either C or PERL. He 
pays no special attention to explaining ordinary syntax or providing 
line-by-line breakdowns. He provides every example in both lan¬ 
guages while maintaining parallel constmction wherever possible. He 
is clearly skilled in both languages, though favoring PERL for its ease 
of string manipulation. 

On this issue of CGI vs. Java, Boutell takes a fairly neutral 
stance. He agrees that most of the apps in the book could run faster 
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under a Java implementation. However, he maintains that CGI “is 
not going away soon” due to its relative ease of implementation and 
guaranteed compatibility across browsers. 

Boutell illustrates the major programming paradigms primarily by 
using a few highly detailed and complete sample applications. Some 
applications are hard-core “commerce” while others are . . . well . . . 
downright fun. The World Birthday Web demonstrates use of the 
PATH_INFO environment variable. The obligatory guest-book style 
comments form demonstrates basic FORM and mail handling. There 
are great examples for client-push, IMAGEMAP, and dynamic gener¬ 
ation of graphics. The tour de force implementation of a Solar System 
Simulator using only server-push is unique in this type of book. The 
Wall Street Simulator is a model package which uses authentication, 
manages user portfolios via flat files, graphs stock history, and dis¬ 
plays transaction logs. These last two examples occupy 20 percent of 
the entire text; if you learn by example, this book may be for you. 

From a technical standpoint, I found the explanations and rec¬ 
ommendations to be straightforward and sound in every case. 
However, some of the advanced material admonishes you to be 
wary of implementing CGI features dependent on Netscape 1.1. 
Since two years have now passed since Netscape 1.1 was released, I 
think we can safely assume that downward compatability is not an 
issue. There’s nothing that rankles me further than blanket state¬ 
ments like “not all browsers support this feature reliably.” 

The only topic slighted is the use of Netscape cookies. This 
receives less than a page of coverage and the only useful bit is the 
pointer to Netscape’s preliminary specification. 

The appendices include some useful information about Boutell’s 
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own freeware utilities: CGIC and “gd.” CGIC is a C library which 
parses incoming HTML FORM fields, gd is the C library for gener¬ 
ating GIF files programmatically. 

The CD-ROM features a few vital tools (CGI-LIB and CGIC) for 
CGI programming, some shareware by Boutell, and source code for all 
of the examples in the book. Aside from the Wusage statistics package, 
it only amounts to 1Mb and could have been distributed on a single 
floppy. Indeed, all examples can be downloaded from the Web site, so 
the CD-ROM serves effectively only as a marketing vehicle. The CD- 
ROM should have at least had copies of PERL v4 and v5 source and 
MS-DOS executables. Instead, users must locate their own copy of 
PERL (perhaps by following a footnote buried at the end of Chapter 1). 



From: HOWTEK!TCLUNE@howtek.mv.com (Tom Clune) 

Subject: Books 

I just wanted to let you know that I happened to be in a city this 
weekend with better book stores than I usually have access to. I was 
able to pick up a copy of Mike Blaszcak’s book ( The Revolutionary 
Guide to MFC4 Programming with Visual C++, WROX Press) and 
the Shepherd and Wingo book ( MFC Internals, Addison-Wesley). 

I know that you have spoken highly of the first book, and it does 
look like a very useful volume. The second was well-regarded by 
some of your readers, and so I thought I’d give it a try. 

I don’t pick up a book based solely on a review. People work dif¬ 
ferently, and what works for one person may be a complete yawn to 
me. But I do keep an eye out for books that get a good review in 
your magazine. If my initial impression in the book store is in synch 
with the reviewer, I’m likely to give the book a try. 

I’m never sure whether a book will pan out until I’ve lived with 
it awhile, but both of these look like they’re going to get used. 

Sounds like a sensible approach to me. Book reviews are just 
opinions, and since I’ve quite disliked some books that sold very 
well, clearly my opinion is not always in the mainstream. However, 
with dozens of new books rolling off the presses each month, I hope 
all the reviews here help someone somewhere connect up with a 
book that otherwise would have been lost in the shuffle. I always get 
a perverse kick out of readers who mention that tney purchased a 
book that got panned here; that means the column is serving its pur¬ 
pose — to get more programmers reading and talking about books. 
Thanks for the feedback! — rib 



In the October 1996 “Books Received," we printed the wrong 
author for Integrating UNIX and PC Network Operating Systems. 
The author of that book is William B. Lund. 


Gosling, Joy, and Steele. The Java Language Specification. Addison- 
Wesley. 864 pages. $36.53. ISBN 0-201-63451-1. For language 
lawyers only, this is the detailed specification of Java from Sun. 

Lindholm and Yellin. The Java Virtual Machine Specification. 
Addison- Wesley. 496 pages. $36.53. ISBN 0-201-63452-X. The 
detailed specification of the Java VM, including the . cl ass file 
format, and detailed byte code reference. Note: much of this 
book is available on the Web. 

Hanson. C Interfaces and Implementations. Addison-Wesley. 544 
pages. $40.83. ISBN 0-201-49841. Demonstrates how to imple¬ 
ment robust, object-oriented interfaces in straight C. □ 
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Reader Profile 



An Interview with Jeremy Bruce-Smith 

Name Jeremy Bruce-Smith 

Company Mentec Ltd 

Years programming 10 

Years programming Windows 4 

Other O/S experience DOS, iRMX86, MTOS, 

home-grown kernel 

Language experience C, C++, PL/M86, Forth, 

Assembler (x86, 680x0, 8051) 
Company size <500 employees 

Principal compiler Visual C++ 

Windows Developer’s Journal: Please tell me about your compa¬ 
ny (how many programmers, how is the labor divided up, etc.). 

Jeremy Bruce-Smith: The company has several divisions. It dis¬ 
tributes DEC products, manufacturing control software products, 
consultancy services, and our own product development area of 25 
people — 3 managers, 5 hardware designers, 3 test/support engi¬ 
neers, and 14 software designers. 

WDJ: You mentioned that your product does video conferencing — 
can you describe the product in a bit more detail? What sort of cus¬ 
tomer does it target? 

JBS: The product is a PC-based (we have both ISA and PCI hard¬ 
ware) program for ISDN Video Conferencing. The final product 
is aimed at the desktop or small conference room customer; how¬ 
ever, we sell to large OEMs who re-badge the product to suit their 
own corporate image. We sell the hardware, a Windows API, and 
a sample application that OEMs can use or replace with their own 
as they see fit. 

WDJ: It sounds like you are once removed from the ultimate end 
user of your product. Do you have any particular mechanisms for 
testing the usability of your product, or for staying in touch with 
customers’ problems and requests? 

JBS: There are advantages in being not too close to end users. We 
tend to get feedback via intermediaries, distributors, and sales peo¬ 
ple. We have to filter these comments a little, as it is a small subset 
of the final customer base. We reckon that if it is difficult to use for 
anybody, we have a problem to fix. 

WDJ: Are you using Win32s to support 16-bit Windows platforms? 

JBS: We had a 3.11 version of our video conferencing applica¬ 
tion. We froze it, ported to Win95, and told our customers that we 
no longer supported the 16-bit version. Not a whimper from any¬ 
one — the only feedback we got was “When is the NT4 version 
coming out?” 

I think that in time the Win95 versus 3.11 issue will sound like 
the Win3.11 versus 3.0 or 2.5 issue does now. Each product has its 


day, but regardless of how good that product is, time moves on. If 
MS were to announce a revamped 16-bit operating system 
(Windows 3.5?), we would sit up, take notice, dust off the 3.11 code 
and probably support it. I don’t expect it to happen, though. 

WDJ: 1 have the same question you got from customers —do you 
plan to do an NT version of this product? 

JBS: Yes, we do. Having gotten to Windows 95 with a 32-bit code 
base, we perceive the step to NT is relatively easy and our current 
plan is to deliver NT-based systems in the first quarter of 1997. 

WDJ: Is the Internet having any effect on your product? Is it having 
any effect on your development process? 

JBS: The effect on the product comes from a perception that video 
conferencing is just another medium like the Internet. So we should 
be able to pick up phone numbers or other information from the Net 
(especially an Intranet) and use it seamlessly. On development, MS 
is now making most information available first on their Web site, so 
that is important. 

WDJ: Are you looking at — or do you plan to look at — Java as a 
potential development tool? 

JBS: No — we’ve not investigated Java in any real depth. 

WDJ: Which operating system are you using while you develop 
code for Win95? If you’re using Win95, have you examined or 
played with NT at all? 

JBS: I am using Win95. I played with NT4 beta 1 but I had prob¬ 
lems on boot-up. One day it trashed my Win95 hard disk so I gave 
up until the final release. I was impressed with the speed in NT4 
(when it actually booted up). 

WDJ: What brand of compiler do you use? Have you ever switched 
brands in the past, or would you consider switching in the future? 

JBS: We use Microsoft exclusively. I used Borland in the dim and 
distant past (before OWL). As Mentec is a Microsoft Solution 
Provider, we could not drop their tools easily! 

WDJ: Compiler vendors face a lot of trade-offs, such as whether to 
focus on adding new features, fixing bugs, improving performance, 
and so on. If you could get just one wish satisfied in the next release 
of your compiler (Visual C++), what would it be? 

JBS: It is becoming more difficult as time goes by to separate the 
true compiler from all the libraries, wizards, debuggers, etc. that 
seem to be part of the front end. I do not use all the features now (if 
I want a feature it may already be part of the package), but the one 
drag is always build time. The faster the better — build time is often 
the time constraint during a debugging session. 

WDJ: Do you make use of OLE (now called ActiveX, I guess) at all 
in your product? 
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JBS: No. Unlike Java, we will be shortly. I don’t think we can 
ignore it any longer. 

WDJ: Can you describe any specifics about how you will make use 
of OLE in future versions of your product? Is OLE support a kind of 
check-off item whose absence makes customers nervous, or is there 
a real demand for some particular OLE functionality? 

JBS: Our current product exposes a C-style DLL interface — this 
forces a functional-based application, which makes it awkward to 
use in any of the more object-oriented environments (e.g.. Visual 
Basic). It would help people in these environments to have an OLE 
control (sorry, ActiveX), or maybe an Automation server, as the 
underlying product is conceptually very object-oriented. 

WDJ: Have you made use of any third-party libraries, or is your 
product pretty much 100 percent custom code? 

JBS: We use MFC and device driver “libraries” for a couple of 
chunks of silicon we have on board, but much of the product is cus¬ 
tom code. 




SDK Annotation #170 


TYPE: Win32 
TOPIC: LoadLibrary 
KEYWORD: LoadLibrary 

When writing code for a Win32 DLL, you may 
be tempted to use declare thread-local variables 
using Windows-specific keywords like this: 

_declspec(thread) int ThisThreadStatus; 

If you do, however, then the resulting DLL can 
only be loaded implicitly (by linking with an 
import library). If any program tries to use 
LoadLibrary() or LoadLibraryEx() to load such a 
DLL, the call will fail and GetLastError() will 
report a code of 1114L (DLL initialization 
failed), even though your DLLs entry point 
never gets called. 

The only work around is to simply not use 

_declspec(thread) in your DLL. Either use the 

TlsXxxx() functions to allocate thread-local 
storage, or use your own algorithm for 
associating data with thread handles. 

Get the entire set of annotations from www.wdj.com or 
CompuServe (file sdkann.zip in section 7 “R&D Publications” 
of forum SDFORUM). Contribute your own annotations via 
email to 70302.2566@compuserve.com (indicate which topic 
in which help file you are annotating). 




TZ 


WDJ: Some programmers use whatever MFC the “wizards” gener¬ 
ate. and then attach to that custom code that is essentially indepen¬ 
dent of MFC. Others design their app’s code as classes that are 
derived from and fit tightly into the MFC class hierarchy. Between 
those two extremes, where would you say your app’s use of MFC 
lies? 

JBS: We probably tend to the latter. I started with the former 
approach and found that I was forever trying to work around MFC. 
I then made a small app in MFC without the wizards — that was 
very instructive. Now I tend as far as I can to derive from existing 
MFC classes and integrate. There is a strong learning curve here; 
until I felt comfortable with nearly all of MFC’s mainstream class¬ 
es, I found myself struggling. 

WDJ: Do you have certain team members who are explicitly the 
MFC experts, or is MFC experience spread somewhat evenly 
around? 

JBS: It tends very much to be concentrated in certain people. 

WDJ: Besides the toolset that comes with your compiler, can you 
list any other programming tools you use (revision control, bug 
tracking, etc.)? 

JBS: We use PVCS for version control. We tried Track Record and 
gave up for bug tracking. We are now using Lotus Notes for bug 
reporting. We use lint. 

WDJ: What sort of problems did you have with Track Record that 
made you abandon it? 

JBS: It was very slow. Also, we felt it was more suited to a very 
large organization with slow response times. If a bug was report¬ 
ed to our support people, we tended to fix it very quickly. The 
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J ^ SDK Annotation #171 


TYPE: Win32 
TOPIC: GetLastError 
KEYWORD: GetLastError 




Some versions of the documentation for 
GetLastError() state that a listing of the error 
codes is found in WINNT.H.The list of error 
codes is actually found in the file WINERROR.H. 


Submitted by: Katy Mulvey 

Get the entire set of annotations from www.wdj.com or 
CompuServe (file sdkann.zip in section 7 “R&D Publications" 
of forum SDFORUM). Contribute your own annotations via 
email to 70302.2566@compuserve.com (indicate which topic 
in which help file you are annotating). 
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typing and form filling of Track Record got in the way rather than 
helped. 


I don’t think the tool vendors are at fault; the compiler vendors 
don’t make it easy to add extra tools to the compiler. 


WDJ: Whose version of lint are you using? What do you see as its WDJ: Can you list any programming book that you’ve found truly 
biggest plus and biggest minus? useful in the last year or two? 


JBS: Gimpel Software PC-Lint. Its big plus is its thoroughness, 
which is also its biggest minus. It is so thorough that the usual MFC 
and Windows programming idioms cause many warnings which can 
obscure real problems. Microsoft seems to have their own dialect of 
C and C++ which we have to adhere to. A lint which understood 
what I meant rather than what I coded would be great! 

WDJ: Why do you think programmers rarely use tools outside their 
compiler? Are there programming tools you would like to see that 
are not currently on the market? What are programming tool ven¬ 
dors doing wrong or right? 

JBS: My reason is simply convenience. Until Windows 95, the 
idea of starting another application to perform a task was time 
consuming — if the compiler would let me do the job at all (how¬ 
ever inefficiently), I would use it. We tried CodeWright Fusion 
once, as it claimed to be integrated with VC++, but it kept crash¬ 
ing and the integration was a little flaky. VC++ 4 is getting very 
good now. 

The one tool I’d love in the compiler is lint. Much of the work 
must be done — after all, the compiler knows all the source files 
and dependencies. It only has to expand its scan a bit for a truly 
good lint. 



J SDK Annotation #172 

TYPE: Win32 

TOPIC: WaitForMultipleObjects 
KEYWORD: WaitForMultipleObjects 

The Windows 95 implementation of this 
function has a bug (see the reference for a 
complete explanation). If the same thread 
claims a mutex more than once, then a second 
thread calls WaitForMultipleObjects() to wait on 
that mutex and at least one other object, 
WaitForMultipleObjects() will incorrectly 
consider the mutex free when the other objects 
being waited on become signaled. 

Reference: p. 44, December 1996 Windows 
Developer’s Journal 

Get the entire set of annotations from www.wdj.com or 
CompuServe (file sdkann.zip in section 7 “R&D Publications" 
of forum SDFORUM). Contribute your own annotations via 
email to 70302.2566@compuserve.com (indicate which topic 
in which help file you are annotating). 


JBS: Only the classic Richter — Advanced Windows. I skipped 
Petzold’s Programming Windows 95 because I’d read the 3.1 ver¬ 
sion, and after reading a chapter or two and skimming the ones on 
DLL’s and OLE, I figured he had nothing new to say. (I am disap¬ 
pointed to say that as I was so impressed with his earlier book.) 

WDJ: Have you attended any conferences you’ve found useful in 
the last few years? 

JBS: No. We don’t see too many here in Ireland and project time- 
frames are too tight for jaunts to the US where the better confer¬ 
ences are usually held. □ 






SDK Annotation #173 


TYPE: Win32 
TOPIC: TBBUTTON 
KEYWORD: TBBUTTON 

The documentation incorrectly claims that for 
separators (fsStyle equal to TBSTYLE_SEP), 
the idCommand field must be zero. In fact, you 
can assign toolbar separators a non-zero ID. In 
fact, it is important to assign unique IDs to 
separators if they have non-default widths so 
the customization features will work properly. 
Also, it’s a common technique to use a “fat” 
separator as a placeholder for a control (such 
as a drop-down listbox) that you want to appear 
on the toolbox. You will need to assign such 
separators a non-zero ID so that you can locate 
the correct position for the control. 

Reference: p. 45, November 1996 Windows 
Developer’s Journal 

Get the entire set of annotations from www.wdj.com or 
CompuServe (file sdkann.zip in section 7 “R&D Publications” 
of forum SDFORUM). Contribute your own annotations via 
email to 70302.2566@compuserve.com (indicate which topic 
in which help file you are annotating). 
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Send your press release to Miller Freeman, Inc., 1601 W. 23rd 
St. Suite 200. Lawrence, KS 66046; fax 913-841-2624; 
wdletter@mfi.com. 

SSI’s SoftProbe x86 Simulator Now in Trial, 
Standard Editions 

Systems & Software, Inc. has released a compact disk contain¬ 
ing the Trial Edition of the SoftProbe x86 Simulator and the 
Standard Edition in encrypted form. SoftProbe x86 is a source and 
symbolic debugger for 32-bit protected-mode and 16-bit real- and 
protected-mode embedded C and assembly applications. The Trial 
Edition also includes an extensive series of tutorials and additional 
information designed to educate the user on functions, features, 
and capabilities of a simulator as a debugger. The Trial Edition is a 
fully functional subset of the Standard Edition with the following 
features limited or removed: Trial Edition simulates 386/387 
processor only, has no Command Window, Trace is limited to 100 
lines, no printed manual or technical support is provided. 

The Standard Edition is in encrypted form on the CD. SSI provides 
the encryption key when the user upgrades to the Standard Edition. 

The Trial Edition is available at no cost. The upgrade to the 
Standard Edition $495. For more information, contact SSI at 
18012 Cowan Ave., Ste. 100, Irvine, CA 92714; 800-788-4386 
xSOO or 714-833-1700 x500; fax 714-833-1900; 
info@syssoft.com; www.ssi.com. 

Rainbow Technologies Introduces 
SentinelWizard GUI 

Rainbow Technologies, Inc. has announced the SentinelWizard 
GUI, a GUI that guides developers in implementing and integrating 
advanced protection into their SentinelSuperPro hardware key. 
Developers describe how they want to sell their products, then 
SentinelWizard automatically programs their SentinelSuperPro key 
and generates pseudocode to complete the protection process. In 
addition to the SentinelWizard, this release of the SentinelSuperPro 
software includes: a tutorial on software protection; the 
SentinelSuperPro key; SentinelSheli, Rainbow’s automatic protection 
software; full online documentation; and SentinelSAFE, an add-on 
that allows for encrypted updating of the SentinelSuperPro key. 

The Sentinel SuperPro Developer's Kit is $19.95. For more 
information, contact Rainbow Technologies, Inc., 50 Technology 
Dr., Irvine, CA 92618; 800-852-8569 x3388 or 714-450-7300; fax 
714-450-7450; sales@rnbo.com; www.rnbo.com. 

Az-Tech Releases EVERLOCK v3.21 

Az-Tech Software has released the EVERLOCK v3.21 Copy 
Protection System. New features in version 3.21 include: the ability to 
completely restrict all network access, even on peer-to-peer networks, 
support for NetWare Client-32 drivers, an improved EVDD Mass 
Duplication Driver, a 32-Bit Error Code program, and an SCB struc¬ 


ture to support 32-bit applications. Version 3.2! is completely back¬ 
ward compatible with v3.10b to enable immediate use of this version. 

EVERLOCK v3.21 Personal System allows a single company 
to protect an unlimited number of diskettes for their own products. 
The Personal System does not require meter counts and may not be 
used for mass duplication using autoloader equipment. 

EVERLOCK v3.21 Professional System supports mass duplica¬ 
tion equipment and is not limited to a single company’s products. 
The Professional System does requires meter counts for protecting 
diskettes, and comes with 100 meter counts, plus an additional 35 
for testing purposes. Additional meter counts may be purchased 
from Az-Tech. 

EVERLOCK v3.21 protected programs can run under DOS 
(v3.3 and later), Windows 3.lx, Windows 95, and O/S 2 (version 
2.1 and later). EVERLOCK also supports Windows NT with a 
few restrictions. 

The Personal System costs $895; the Professional System costs 
$295. For more information, contact Az-Tech Software, Inc., 201 E. 
Franklin St., Ste. 11, Richmond, MO 64085-1883; 816-776-2700; 
fax 816-776-8398; BBS 816-776-8671; sales@az-tech.com; 
www.az-tech.com. 

PC-Charge Now Available as ActiveX Control 

GO Software has released PC-Charge ActiveX Control. PC- 
Charge allows people to use any major credit card to buy from any 
merchant, no matter what bank the merchant uses. Unlike other 
products, which require businesses to set up special accounts, PC- 
Charge allows businesses to use their existing bank relationships. 
The PC-Charge ActiveX Control allows PC-Charge to interact with 
OLE-enabled applications. PC-Charge supports check guarantee 
and verification services along with ATM/debit card transactions. 

PC-Charge costs $295; PC-Charge ActiveX Control costs $130. 
For more information, contact GO Software, Inc., 31 Sherborne 
Rd., Savannah, GA 31419; 912-925-4048; fax 912-927-0214; 
gosoft@netpath.com; www.netpath.com/~gosoft/. 

KAI Ships NiTro*Code for NT 

Kuck & Associates, Inc. has shipped NiTro*Code for use on 
Pentium/Pentium Pro machines under Windows NT with one or 
more processors. NiTro*Code is a source code optimization tool 
designed to enhance FORTRAN 77 code. NiTro*Code can also be 
used to enable parallelization, allowing Windows NT programmers 
to automatically take advantage of multiple processors. 

NiTro*Code runs on UNIX workstations such as Digital work¬ 
stations, Silicon Graphics systems, IBM RS/6000 workstations, HP 
9000 Series 700/800, and Sun SPARC-stations. This technology 
has been adapted to work with the Microsoft FORTRAN 
Powerstation compiler on the Windows NT platform. 

NiTro*Code costs $199 for the serial version and $299 for the 
parallel version; both include a 60-day, money-back guarantee. For 
more information, contact Kuck & Associates, Inc., 1906 Fox Dr., 
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Champaign, IL 61820; 217-356-2288; fax 217-356-5199; 
nitrocode@kai.com; www.kai.com/nitrocode/. 

NewCode Technology Ports NCi C++ 
Interpreter to NT 

NewCode Technology has announced that it has ported NCi to 
Windows NT. NCi, a standards-compliant C++ interpreter used to 
embed in end-user applications, provides end users of Windows NT 
applications the ability to extend functionality in their C++ products 
without opening up large portions of the development environment. 

NCi allows interpreted code to call compiled code with full type 
checking. It also allows new variables, functions, and types (including 
subclasses) to be created at runtime. In addition, it ensures proper 
interaction between all interpreted code and compiled code. 

NCi is available for Windows NT and Windows 95 working 
with Visual C++, for SunOS and Solaris working with SparcWorks 
C++, and for HP-UX working with the HP C++ compiler. 

NCi is priced separately for development and deployment: prices 
are per developer. Single licenses start at $5,000 and fall to $2,500 
each in quantity. For preliminary evaluation, you can download the 
interpreter free of charge via FTP. For more information, contact 
NewCode Technology, Inc., One Hollis St., Ste. 211, Wellesley, MA 
02181; 800-639-2633 or 508-454-7255; fax 508-454-7559; 
request@newcode.com; www.newcode.com. 

Stingray Announces Objective Plug-in 1.0 

Stingray has released Objective Plug-in 1.0, a product that auto¬ 
mates the process of building plug-ins for the Netscape Plug-in 
API. Objective Plug-in contains two key components: the 
Objective Plug-in Wizard and three Objective Plug-in classes that 
create the bond between the Netscape Plug-in API and the 
Microsoft Foundation Classes. 

The Objective Plug-in classes are: COPWinApp, a CwinApp 
derivative that handles the creation and destruction of an MFC- 
based plug-in; COPIFrameWnd, a CframeWnd derivative that pro¬ 
vides a drawing area for an MFC-based plug-in's view, toolbars, 
and status bars; and COPIDocTemplate, a special CsingleDoc 
Template derivative that automatically creates a document and 
view when the plug-in is provided with a file stream. 

The introductory price for Objective Plug-in is $995, which 
includes one year of technical support and upgrades at no addi¬ 
tional cost. For more information, contact Stingray Software, 
Inc., 1201-F Raleigh Rd., Ste. 140, Chapel Hill, NC 27514; 
800-924-4223 or 919-933-0863; fax 919-933-0892; 
sales@stingsoft.com; www.stingsoft.com. 

Acadia Releases Acadia Infuse for 95, NT 

Acadia Software has introduced Acadia Infuse, a JavaScript 
editing tool for Windows 95 and NT. Acadia Infuse rapidly creates 
JavaScript scripts and Netscape ONE open network environment 
applications within a visual drag-and-drop environment. Features 
include: an editor with JavaScript and HTML color syntax high¬ 
lighting; an integrated script navigator; visual trees to browse 
JavaScript objects and language elements; a context-sensitive 
JavaScript language reference built into the editing environment; 
the ability to drop in commonly-used JavaScript and Live Wire 
code into a source file; support for HTML with its visual HTML 
Tag tree and toolbar; the ability to preview scripts in Netscape 
Navigator and/or Microsoft Internet Explorer; and the ability to 


compile LiveWire applications from within Acadia Infuse and 
quickly access the LiveWire Site Manager. 

Acadia Infuse costs $129.99. For more information, contact 
Acadia Software, Inc., 1300 Massachusetts Are., Ste. 220, 
Boxborough, MA 01719-2203; 508-264-4881; fax 508-635-9211; 
info@acadians.com; www.acadians.com. 

Azalea Ships carrick Encryption Utility 

Azalea Software, Inc. has shipped vl .1 of their carrick encryp¬ 
tion utility that provides private key encryption. Unlike most other 
computer security products, carrick is based on the new Blowfish 
encryption. While others debate the merits Of 40- or 56-bit key 
lengths, carrick allows keys up to 448-bits long. Because of the 
strength of the underlying algorithm, the U.S. government won’t 
allow carrick to be sold outside the U.S. 

The Windows version runs under Windows 3.x, Windows 95, and 
Windows NT. Improvements to the Windows product include drag- 
and-drop support from File Manager, the option to save the two 
halves of a key to disk, notification of potentially weak keys, and a 
helpful rotating tip of the day highlighting sound security practices. 

carrick costs $159 or $199 for two copies. For more information, 
contact Azalea Software, Inc., RO. Box 16745, Seattle, WA 
98116-0745; 800-362-7978; fax 206-937-5919; 
carrick@azalea.com; www.encryption.com. 

Eschalon Releases Setup Desktop 2.2 for 95, NT 

Eschalon Development Inc. has released version 2.2 of 
Eschalon Setup Desktop. Version 2.2 is designed for Windows 95 
and NT and adds full support for Delphi and VB including BDE, 
ODBC, and DOA/ROA. It provides a setup toolkit that enables the 
creation of installations. 

Eschalon Setup Desktop includes features such as: a familiar 
Wizard interface, Windows 95 shortcuts, a ReadMe and License 
viewer, background and billboard options, icon and shortcut cre¬ 
ation, custom prompting, verification of existing requirements, par¬ 
tial setup support (minimal, full, custom), registry and INI support, 
version checking, disk and registry branding, automatic disk build¬ 
ing, high yield compression, registration of OCX or ActiveX com¬ 
ponents, passwords and encryption, multi-lingual support, an unin¬ 
stall, and single, exe support. 

Setup Desktop costs $199.95. For more information, contact 
Eschalon Development Inc., 24-2979 Panorama Dr., Coquitlam, 

BC V3E 2W8 Canada; toll free: 888-372-4256; fax 604-945-7602; 
www.eschalon.com. 

BlueWater Systems Ships WinDK for NT 4.0 

BlueWater Systems has shipped the WinDK Device Driver 
Development Kit for developing device drivers for Windows NT 
4.0 and 3.51. The WinDK Kit supports Microsoft’s Windows NT 
DDK kernel mode driver development, including: registry, 
resource/port assignment, event logging/debugging/trace func¬ 
tions, multiple queues, address mapping, filtering, UNICODE 
strings, ISA, EISA, PCI, bus master and slave DMA, and pro¬ 
grammed I/O. 

The WinDK Kit follows the guidelines of the MS NT DDK and 
MS Developers Network to improve portability of drivers. Device 
drivers created with the WinDK Kit use features of NT that have 
been difficult to access, such as performance counters and debug¬ 
ger extensions. 
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The WinDK Kit includes sample device drivers and the WinDK 
class libraries. 

The WinDK Device Driver Development Kit for NT 4.0 costs 
$795, which includes six months of free support and 90 days of 
free upgrades. An introductory price of $595 is available for the 
WinDK Intel version. For more information, contact BlueWater 
Systems, Inc., 144 Railroad Ave., P.O. Box 776, Edmonds, WA 
98020-0776; 800-962-2114 or 206-771-3610; fax 206-771-2742; 
info@bluewatersystems.com; www.bluewatersystems.com. 

Raima Releases Raima Object Manager v3.0 

Raima Corporation has released Raima Object Manager 3.0, a 
C++ class library that encapsulates object storage and database 
navigation into C++ class definitions. Features include an imple¬ 
mentation of member functions as Server extensions for Velocis 
Database Server, a feature that allows application functions to be 
hosted on the database server and access the server at a low level. 
Also, Object Manager supports access to the RDM and Velocis 
“d_” C-AP1, enabling developers to call these functions rather than 
Object Manager member classes when appropriate. 

The functionality required to store objects is built into the 
Object Manager base classes, and version 3.0 provides several new 
member functions included in the TransAction class, as well as 
new member functions in the storable object class that allow the 
use of different keys. 

Object Manager v3.0 for Windows costs $495. Pricing for the 
UNIX platform varies according to your hardware. For more infor¬ 
mation. contact Raima Corporation, 1605 NW Sammamish Rd. 
mO, Issaquah, WA 98027; 800-327-2462 or 206-557-0200; fax 
206-557-5200; sales@raima.com; www.raima.com. 

Union Pacific Technologies Announces 
PQMPIus 1.6 

Union Pacific Technologies has announced Release 1.6 of 
PQMPIus, a Windows-based productivity and quality measurement 
system for application development. PQMPIus provides project 
managers with a system for project estimating, scheduling, risk 
assessment, corporate value assessment, and productivity analysis. 
It maps the software life cycle up front and allows project man¬ 
agers to re-estimate in each development phase. PQMPIus can cal¬ 
culate an applications technical quality, and offers a standard 
approach for managing projects through the use of consistent 
assessment techniques resident in the software. 

With Release 1.6, PQMPIus makes available a shared database 
through its support of Sybase’s SQL Anywhere. PQMPIus inter¬ 
faces with major project management systems such as Microsoft 
Project, AGS Management Systems’ Firstcase, and ABT’s Project 
Workbench. 

PQMPIus runs on Windows 3.X, Windows NT. Win OS/2, and 
Windows 95. 

PQMPIus costs $5,900 for a single copy; volume discounts are 
available. For more information, contact Union Pacific Technologies, 
7930 Clayton Rd., St. Louis, MO 63117-1368; 800-776-0679 or 
314-768-6800; www.up.com/upt. 

Eagle Research Ships VB2D Visual Basic to 
Delphi Translator v2.0 

Eagle Research has shipped version 2.0 of its Visual Basic to 
Delphi (VB2D) translator. This new release of VB2D features sev¬ 


eral improvements, including the ability to translate to 32-bit 
Delphi 2.0 from Visual Basic versions 3.0 or 4.0, online reporting, 
nearly 100 percent conversion of most database code, and automat¬ 
ic replacement of commonly used VBXs. 

For VB projects that use Access or other databases through the 
JET Database Engine, VB2D replaces standard VB data-aware con¬ 
trols with Eagle’s JETset controls for Delphi. JETset controls are 
derived from standard Delphi data-aware controls, but instead of con¬ 
necting to Borland's Database Engine (BDE), they connect directly to 
Microsoft’s JET Database Engine, supporting Access functionality 
not available through the BDE. Besides the performance advantage, 
this approach also means most database-handling code in the VB pro¬ 
ject will translate correctly for the new Delphi program. 

The Standard Edition of VB2D costs $150; the Professional 
Edition costs $450 and includes a 30-day, unconditional money-back 
guarantee. For more information, contact Eagle Research, Inc., 360 
Ritch St., Ste. 300, San Francisco, CA 94107; 415-495-3136; fax 
415-495-3638; sales@xeaglex.com; www.xeaglex.com. 

Evergreen Announces Support for Raima 
Velocis Database Server 

Evergreen Software Tools, Inc. has announced that their latest 
version of EasyER 1.1 supports Raima’s Velocis Database Server. 
EasyER 1.1. a too! for data modeling and design of desktop and 
client/server databases and applications, uses entity-relationship 
diagrams (ERDs). EasyER supports the popular Object-Oriented 
methods (Coad-Yourdon, Rumbaugh OMT and the emerging 
Unified modeling language) and the most up-to-date databases and 
application development tools. 

EasyER 1.1 supports the definition of tables, columns, indexes, 
primary keys, and foreign keys for Raima Velocis and can both 
generate and reverse-engineer database schemas using ODBC con¬ 
nections. Or. EasyER can generate SQL DDL scripts to a text file 
for processing by the Velocis SQL processor. 

EasyER 1.1 costs $495. For more information, contact Evergreen 
Software Tools, Inc., 15444 N.E. 95th St., Ste. 244, Redmond, WA 
98052; 800-929-5194 or 206-881-5149; fax 206-883-7676; 
CompuServe (GO SDFORUM) EasyCASE library (#17); 
marketing @esti. com; www. esti. com. 

OrbixWeb 2.0 Heralds New Generation Applets 

IONA has announced the latest release of OrbixWeb 2.0. The tra¬ 
ditional use of Java is to download applets into the browser. Using 
OrbixWeb, those applets can invoke the services of CORBA-based 
components anywhere in the world and become server components. 
This transforms commercial browsers into live servers which can be 
updated with new information as and when it occurs. 

OrbixWeb is fully-compatible with the Orbix Desktop for 
Windows product line which delivers ActiveX interworking out 
of the box. 

The OrbixWeb Developer Kit costs $2,500. The OrbixWeb 2.0 
runtime is available at no cost and may be freely distributed. For more 
information, contact IONA Technologies, Inc., 201 Broadway, Floor 
3, Cambridge, MA 02139-1955; 800-672-4948 or 617-679-0900; fax 
617-679-0910; info@iona.com; www.iona.com. 
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Send letters to wdletter@mfi.com. 


From: Laxmikant Gunda 

<lax@querisoft.com> 

Subject: Tech Tips collection 
Hello, 

I downloaded the SDK annotations col¬ 
lection, which is of great help to me. It's a 
great job done!! I would very much appre¬ 
ciate it if I could get a collection of all the 
Tech Tips. 

We distribute code and the SDK annota¬ 
tions for free, but our ongoing addiction to 
food and shelter forces us to request filthy 
lucre for most of the other parts of the mag¬ 
azine. The WDJ CD-ROM contains almost 
all the magazine's editorial content 
(including Tech Tips, of course) from 
December 1991 through December 1995, 
and can be ordered for $49.95 plus ship¬ 
ping through our Web site at WWW . wd j . COIH. 
It’s got a full-text search engine, and I have 
to say / can’t figure out how I got along 
without it all these years. —rib 


Subject: traplist vxd 
From: Michael Zarky 

<liebig@bcf.usc.edu> at Internet 
Dear Friends, 

A month ago I emailed you a letter to be 
forwarded to one of your authors, Karen 
Hazzah. I have had no reply and wonder 
whether you can help me directly. 

I enjoyed her recent article “Port I/O 
under Windows” in the June 1996 WDJ and 
hoped to make use of the Traplist VxD for 
my own use. Unfortunately, the complete 
VxD that I downloaded from the ftp site 
wouldn’t run, and when I tried to assemble 
the source code, the file IFSMGR. Inc referred 
to therein was missing. It doesn’t seem to be 
part of the DDK, either. What should I do? It 
would help me a lot to unlock some of the 
secrets of various soundcards. 

Am I the only one unable to run this? I 
hope I don’t have to recreate the whole 
thing on my own — I just don’t have the 
time. I would love to have it, as it seemed a 
very useful program. 

Thanks very much. 

There was an unfortunate typographical 
error in that article: page 36 says that the 
IFSMGR services are available only under 


Windows 3.1, but should have said that 
these services are available only under 
Windows 95. So, the TRAPLIST VxD can’t 
be built for Windows 3.1, only for Windows 
95. I apologize for the error, but thanks for 
pointing it out for us. —rib 


Sb: #Ron Burk is evil! 

Fm: Tim Farley 74262,2157 

Last year, I was working on a client-serv¬ 
er product whose server component ran on 
Windows NT. Management decreed that we 
should convert the product so that it ran as a 
service. Lo and behold, the very next issue 
of Windows Developer’s Journal contained 
a beginner’s introduction to services. “What 
luck!” I exclaimed, as I joyfully read the arti¬ 
cle. Later in our project, we found a problem 
where our service needed to interact with the 
desktop. “Gee,” I thought, “there doesn’t 
seem to be any easy way around this.” Soon, 
the next issue of WDJ arrives, and what do I 
find but an entire article about having ser¬ 
vices interact with the desktop. 

Now I’ve switched jobs and am working 
at a totally different firm. A colleague came 
up to me the other day and asked if I knew 
a way to trap API calls under Windows 95. 
“Why do you want to do this?” I asked. He 
responded that he wanted to build some¬ 
thing that behaved like DBWIN did under 
Windows 3.x. Not two days later, the latest 
issue of WDJ arrives, and what do I find but 
an article entitled “A dbwin Utility for 
Win95”? I quickly passed this along to my 
colleague. I was shocked and stunned! 

Ron, I demand to know how you are 
doing this! Do you have some sort of strange 
psychic powers? Are you in league with 
Satan? Have you invented time travel? Or 
perhaps you have secreted some sort of trans¬ 
mitting device on my person so that you can 
spy on my every move. I suppose your next 
move is to start transmitting messages into 
my brain using this, making me your unwill¬ 
ing programmer-slave. I will not stand for 
this! I DEMAND THAT YOU STOP THIS! 
You are invading my privacy. God only 
knows what other use you are making of the 
information you steal from your probing into 
my personal life. 

YOU ARE EVIL, RON BURK! EVIL, I 
TELL YOU! 

PS. All of this is absolutely true. Well, 
maybe not the part about Satan. 


From: Alex Shmidt [73302,60] 

Re: Ron Burk is evil! 

Tim, I hope you and Ron won’t mind my 
jumping in as I’m going to throw in a few 
more examples of Ron’s psychic power. 

In chronological order: 

1. (Ages ago) I’m about to hit a deadline on 
the project involving DOS-to-Windows 
programs interactions. One week before 
I have to deliver, Tom Olsen’s Dospipe 
article arrives. 

2. I’ve written a tiny library to get around 
“below 1 Meg” problem and even pub¬ 
lished it on some forum. My boss tells me 
the library doesn’t solve a problem and 
can’t be used for a custom display driver. 
The very next day, WDJ arrives with an 
article (unfortunately I forgot the author’s 
name) and a similar library. My reputation 
is saved ;-). 

3. I’m looking for a way to keep frequently 
used code fragments with a treeview front- 
end, and decided to build it around .ini 
file structure. Obviously, just constructing 
.ini files turned out to be no joy. When 
I'm about to give up. Ron’s article on the 
subject arrives where he a) rules out .ini 
files as the very convoluted solution, and b) 
demonstrates a very clever use of long file¬ 
names. Now I’m happily using Ron’s 
appoach with Codewright. 

To confuse Ron’s dialing mechanism 
into my biowaves, I always start reading 
WDJ from editorial, but. . . 

4. In that little spare time I have, I’m trying 
to study JVM and keep telling myself 
I’m crazy and this is a dead-end knowl¬ 
edge. Not any more! In the latest issue’s 
editorial, Ron confesses he's doing the 
same (but certainly more consistently). 
I’m encouraged and my sanity is saved. 

Well, I have to think whether I want to 
stop this invasion into my private life now. 
This is magic, but it’s rather white, don’t 
you think? Unless, of course, Ron one day 
decides to use it the other way around. But 
hey, there are already two of us. How much 
evidence do we need to start a class action 
lawsuit? ;-) 

If you can just tie this all in to the 
Warren Commission somehow, I think 
you’ve got the makings of a great “X-Files” 
episode. —rib 
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From: Michael Sawczyn 
<msawczyn@sylvester.pfdpf.state.oh.us> 
Subject: SDK Annotations failure 
Ron, 

I’m having trouble with the SDK annota¬ 
tions from WDJ. My platform is NT4 with 
BC5.01 installed. Anntater tries to fire off the 
16-bit WinHelp, which can't read my 
wi n32. hi p file. As a consequence, the anno¬ 
tation additions fail. Is this a known problem? 

Well, it wasn’t known before, but it is 
now. I can’t see any other easy 
workaround, so I’ve started including 
anntat32.exe, a 32-bit version of 
anntater.exe. This seems to solve the 
problem for Win32 platforms trying to 
access win32.hip. I apologize in advance 


to everyone for the size of sdkann.zip — 
it’s over 250Kb now! —rib 


From: Toni Paine <tonip@ento.csiro.au> 
Ron, 

I am having trouble with the current ver¬ 
sion of anntater.exe. I have previously 
used the program successfully, but not this 
last time. Here is what happens — 
ANNTATER starts and I select annotations 
for Win31. The program successfully locates 
the help file (c:\bc45\bin\win31wh.hlp) 
and then crashes with a GPF in user.exe at 
0001 : 3al6 before I have a chance to do any¬ 
thing else. If this was a fault in the program, 
I’m sure you would have heard by now. So 
what am I missing or could something be 
corrupt? 


In searching for a solution, I ran it 
through BoundsChecker. It reported a failed 
call to GetProcAddressl ) early on (before I 
made my selection), and when the GPF 
occurred, the last Windows “event” was: 

CallWindowProctPTR, HWND, 
MSG:WM_USER+000A, 

WPARAM:0006, 

LPARAM:2BD70000). 

This may be of help or could be misleading. 
Any suggestions would be appreciated. The 
annotations are a valuable resource. 

It looks like I introduced a bug when I 
tried to make AnnTater a little fancier. I 
wanted to change the user interface so that 
it displayed a checkmark next to each SDK 
annotation that was successfully installed 



Client/Server CASE Tool! 



ER modelling tool with Form Generator, Logical & Physical 
Database Design, Reverse Engineering, Triggers & Stored 
Procedures, Scripting Language, Programmable Database 
support and hundreds of other features. 

Pro Edition Only $485 
Case Laboratories, PB 58, 4033 Forus, Norway 
Fax (47)51 57 01 17 email: JANVB@CASELABS.COM 


Download a EPEE Demo from 
inrir.i aselahs.c om 
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CDROMs! 


Linux Slackware® 96 -4 disc set. Slackware 96 ‘OFFICIAL* 
release by Patrick Volkerding. Internet's favorite! You get 
complete source code and compilers. Free 36 page 
installation booklet. No floppy disc install! $39.95 

Slackware subscription - convenient 3 month updates. $24.95 
FreeBSD® 2.1.5 - Berkeley BSD for PC. Solid Unix®4ike, sre, 

XFree86 3.1.2, dev. tools. 2 CDs. (Subscr. every 6 mo. $24.95) $39.95 
CUG Library - 10 years C/C++ Users' Journal sre, listings. $49.95 
CICA® MS Windows - 1,916 up-to-date shareware. 2 CDs. $29.95' 
Hobbes® OS/2 Archived - 950 MB OS/2 apps, drivers. $29.95' 

Blackhawk 95 - 520 MB great Windows 95 applications. $29.95' 
Toolkit for Quake - add-ons for the hottest selling game. $19.95' 
Simtel® MSDOS - 2 disc set, classic MSDOS shareware. $29.95' 
Science Library - Technical, engineering shareware + book. $39.95' 
Perl - Source, binaries for many systems, documents. $39.95 
Math Solutions - Math programs, source code, docs. $39.95' 
POV-Ray - 3-D Raytracing: 1000 wow! images, sre/binaries. $39.95 
‘Shareware programs require separate payment to authors if found useful. 


ORDER NOW! 1-800-786-9907 


Shipping is $5 in USA/Canada/Mexico, $9 Overseas per order. 
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Walnut Creek CDROM 

Suite D-694, 4041 Pike Lane, Concord CA 94520 
Phone: +1-510-674-0783 • FAX: +1-510-674-0821 • email:orders@cdrom.com 
All of our CDROMs have a one year unconditional guarantee! 

Call today for your free catalog of all our CDROM titles! 

See these products free at http://www.cdrom.com/ 
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Web Page: http://www.bluewatersystems.com 

/"~ N \ HASSLE FREE HARDWARE CONTROL 

©WSnRT 


New Features: 
•Script 
Language 
-if - else 


-Arrays 
• Faster 
Execution! 
-Avg. 15% 
speed 


Windows95" 


Win32* 


►NT" 


Binary Compatible 

Spend your time writing your App...not 
wading through D.D.K. documentation! 
Fast hardware control under Win32® 
without the device driver kit! 

/PortI/O / MemoryI/O /Interupts 
OCX version also available 


ut Alpha 

NO RUNTIME ROYALTIES 

VISA, MC, AMEX & Approved P.0, accepted 
Tel (206)771-3610 • Fax (206)771-2742 
E-Mail: info@bluewatersystems.com 

( 800 ) 962-2114 
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ActiveX Charge 

Add Credit Card Processing to Your Applications. 


PC-Charge makes it easy to process Credit Cards, Debit Cards 
and Check services in your Windows Applications. Sales, 
Credits, Voids-everything you need to replace that bank card 
terminal (little black box). 

• ActiveX and VBX Controls make it easy to integrate. 

• Pre-Certified with all major credit card processing 
companies. 

• Single and Multi-User Versions. 

• Works with Visual Basic. Visual C++, PowerBuilder, 
Access, Delphi and many more languages. 

• 30 day money back guarantee. 

• Starts at $295. 



The Leaders in Innovative Transaction Processing Solutions 

31 Sherborne Road • Savannah, GA 31419 
Tele: (912) 925-4048 Fax: (912) 927-0214 
http://www.gosoftinc.com 
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Software Developers! 


PROTECT YOUr 
Software. 
INCREASE Your 
Revenues. 

With software piracy costing you 
50% of your revenues, you can’t 
afford not to protect! HASP® is 
the industry's most secure, flexible 
and easy-to-use software protection 
solution - rated #1 by the NSTL! 

HASP will help you increase sales, control 
distribution, prevent piracy, monitor network 
licensing, and much more! 

To learn how you can easily sell more software - call 
now to order your low-cost HASP Developer’s Kit! 



Norh America 800-223-4277 
212-564-5678, Fax: 212-564-3377 
E-mail: hasp.sales@us.aks.com 
International -972-3-636 2222 
Fax: 972-3-537 5796 
E-mail: hasp.sales@aks.com 


www.aks.com 


ALADDIN' 


The Professional’s Choice 
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UNIVERSITY <fW ASHINGTON 


College of Engineering 

presents a two-day course 

Designing and Writing Effective Online 
Help For Windows 

Covers all aspects of help design, writing, 
layout, graphics, and navigation — plus an 
overview of authoring tools — for Windows 3.1 
and '95 Help and the new HTML help. 

Instructors: Dave Farkas, UW Faculty 

Joe Welinskc, Win I lelp Trainer 

Contact: Susan G. Stone, (206) 543-5539 
Email :< stonc@rio.engr.washington.edu> 
On line: http://www.engr.washington.edu/epp/ 
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Developer Jobs! 

Internet: ngi@scientific.com 

Commercial software developers should con¬ 
sider registering with Scientific Placement. 
R&D jobs for software engineers, SQA, prod¬ 
uct managers, etc. Nationwide contacts with 
both large and small companies including 
start-ups. Many clients develop commercial 
software products. Most develop for Win¬ 
dows, NT, Macintosh, OS/2, and Unix based 
platforms. We also recruit in other leading 
edge technology areas such as PDA, low level 
and real-time, compilers, etc. Managed by 
graduate engineers. Send resum6 or call fora 
marketability assessment. Never a fee. 

Scientific Placement, Inc. 
800-231-5920 Fax 800-757-9003 
http://www.scientific.com 


CompuServe: 71250,3001 AOLtdavesmaU 
SPI8, Box 19949, Houston, TX 77224 
713-496-6100 Fax:713-496-0373 
SP18, Box 71. San Ramon. CA 94583 
510-733-6168 Beth@spica.bdtcorn 
SPI8, P. O. Box 202676, Austin. TX 78720-2676 
512-331-0302 lcj@zilker.net 
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VICTOR 

Image Processing Library 

Fast BMP/TIFF/PCX/GIF/TGA/JPEG 
Powerful image processing: brightness, 
contrast, sharpen, smooth, equalize, 
create filters, resize, rotate, +++ 
Accurate color reduction to optimum, 
specific, or standard palette 
Print halftone, diffusion scatter, or color 
Scan with all HP scanners 
Operate on single image, multiple 
images, or any image area 
Crop, combine, and compare images 

Victor Image Processing Library 
Dos lib $199, 16-bit DLL $299, 32-bit DLL $499 

Catenary Systems 
314-962-7833/fax: 314-962-8037 
email: victor@catenary.com 

askforfreedemo srcavail noroyalties 
Visit our website for demos, app notes, and sample code 

http://www.catenary.com/victor 
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Object Outline® 


• New Version 

• Generates documentation directly 
from the source code 

• Metrics 

• HTML and RTF output 

• No source code changes 

• Windows 95 and NT 3.51, NT 4.0 

• FREE evaluation version at www.bbeesoft.com 

Order by calling 1 - 800 - 214 - 4746 . 
fax an order to 1 -800-657-8141, costs s 297 US dollars 



email info@bbeesoft.com, PO Box 541, Hudson, MA 01749 
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Market and 
Publish Software! 


Astron Publishing, Inc. seeks software 
products to publish in the marketplace. 

If you have developed an innovative and 
creative game, program or utility, Astor 
will review your program, determine its 
market potential, and publish the 
finished product. 

As tron 

PUBLISHING, INC. 

1101 17th Street, N.W., Suite 408 
Washington, D.C. 20036 

Tel 202-331 -9789 Fax:202-872-0286 
Toll Free: 800-982-2578 
http://www.wbonepub.com 


GAMES WANTED! 
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6 Great Controls! 


TE Edit Control (Advanced RTF control). 
HTML Viewer Control Add-on for TE. 
ReportEase Plus (report writer engine). 
SpellTime DLL and dictionary. 

Rich Text Grid control. 

ChartPro (bar,pie,line, hilo,point) control. 


All products include complete 
source code, are royalty free and 
available for 16 or 32 bits. 

Sub Systems, Inc. 

11 Tiger Row,Georgetown, MA 01833 
508-352-9020 Fax: 508-352-9019 
Demos: www.subsystems.com 
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during the current session, one of several 
great ideas submitted by readers. That way, 
you could just have AnnTater “auto- 
install” the entire list (which currently 
takes a few minutes), then go back and 
hand check the ones it had a problem with. 
Unfortunately, my owner-draw code for the 
checkmarks in the listbox had a bug that 
could cause a GPF. I think I've got the bug 
fixed, and the repaired version is now 
available on my home page and on 
www.wdj.com. Thanks for the detailed 
information on the GPF. —rib 


Hi. Mr. Ron Burk, 

I am interested in your paper “The Least 
You Need To Know About OLE Compound 
Files” in the July 1996 Windows 


Developer’s Journal. Could you please 
send me the source code of the sample 
“comdump”? Any more complete samples 
will be appreciated. 

Thank you very much. 

Sam Cai 

Lead Programmer / KRONOS 

The Table of Contents page in each 
issue lists all the places you can get source 
code for WDJ articles, but our surveys 
show that most of our readers now have 
access to the Web, so all most readers real¬ 
ly have to remember is www.wdj.com. 
Having a single access point certainly 
makes maintenance a lot easier. If we fix a 
bug or add a missing file to the archive, we 
can just do it in one place and not worry so 


much about all the copies that have drifted 
out into cyberspace. —rib 


Thiadmer Riemersma [100115,2074] 

Ron, 

I read your article “Building Win32 
DLLs the Right Way” (fairly late, I know, 
but there was a local delivery problem), and 
I have two comments: 

1. Building DLLs with undecorated names 
with Watcom C 10.6 is not obvious 
either. You basically go through the same 
procedure as Microsoft: list the functions 
with decorated and undecorated names 
in the . def file, except that Watcom C 
uses a special “export” file instead of a 
.def file (the default extension of which 
is . 1 be). 



Marketplace 
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Need Printing & Previewing 
For Your Window^Apps? 

Download a fully-functioning trial of Virtual Print Engine " 
right now at www.arialsoftware.com/200.htm 

• Well-documented DLL 

• 1/1 Omm control 

• Device-independent 

• Handles text ant/graphics 

• to routines! 

16-bit or 32-bit: $398 Both: $598 



For more info or free demo: 

E-Mail: sales@arialsoftware.com 


Phone: (503) 6464515 
Fax: (503) 6464)717 



"Your VPE DLL is great!! Thanks again! 

It is just what the doctor ordered, and will 
save me many hours of work." 

-B. Bennett, senior software engineer 
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C and C++ DOCUMENTATION 


!! VERSION 6.2 !! 

• C-CALL ($69) Graphic-tree of caller/called 
functions, cross-ref, file/function index. 

• C-CMT ($69) Creates/inserts/updates comment- 
blocks for each function, listing the functions 
and identifiers used by it. 

• C-METRIC ($59) Counts path complexity, counts 
comments, code, 'C' statements. 

• C-LIST ($69) Lists and action-diagrams, or 
reformats into standard formats. 

• C-REF ($69) Creates cross-reference of local/ 
global/define/parameter identifiers. 

• C-D0C ($199) Package All 5 programs integrated 
as DOS program. <10,000 lines. 

V6.0 C-BR0WSE Windows graphic-tree viewer. 

• C-D0C Professional ($299) DOS, Windows, OS/2. 
3-ring binder/case. <1,000,000 lines. 

30-DAY Money-back guarantee. CALL NOW! 

SOFTWARE BLACKSMITHS INC. 

6064 St Ives Way, Mississauga Voice/Fax (905) 858-4466 
0NT Canada L5N-4M1 http://www.swbs.com 


Please see Ad Index for our larger ad. 
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IW3 WWW Connectivity *** UNIQUE *** 

• Connect applications with the World Wide Web • Make 
host application useable through web browsers • 3270, 
5250 and 9750 available via HLLAPI • HTML generator 

• VisualBasic support - Write a web server with VB - 

Picasso Interface Generator 

• Creates new interfaces for existing host and DOS apps. 

• Supports 9750, 3270 and 5250. • HLLAPI interface • 
Built-in form editor • Transformation tools • Codegenerator 
produces complete program source • Host screen capture. 
WWW option available. 

PrimaVista Interactive Presentation 

• Annotations with mouse, keyboard and pen. • Screen 
camera, graphics import, Photo CD. • Arrange, scale, crop, 
undo and redo. • RTF editor and thumbnail images. 

TOOls PrimaCamera and WinGate Products 

• Camera captures popup menus • WinGate: DOS pipes • 
RobinHood. DOS box control • WinTunnel: data exchange 

PrintForm Formatting Tool 

• Makes impossible reports possible. • Lean, mean and 
fast, supports MFC • Suited for object oriented data bases. 

0) +49.89.78581204 ESC 
1 +49.89.78581205 0) +1.913.832.2070 
info@cobasoft.com ®+1.913.832.8787 
L/ODSSOit www.cobasoft.comwww.esconnect.com 
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S/W ENGINEERING POSITIONS NATIONWIDE 


We Understand 
Programmer's 
Mind . 31 


When the country’s 
top firms look for 
the best develop¬ 
ers available, they 
turn to Bateman. 
Why? Because we 
specialize in MS 
Windows. NT, OS/ 
2 and Macintosh re¬ 
cruiting nationwide. 
So if it's time for a 
career move, give 
us a call. We un¬ 
derstand your 
skills, and the mar¬ 
ketplace forthem... 
we understand you. 


1* Bateman Inc. 


5847A Uplander Way 
Culver City, CA 90230 
Tel: 310-641-4100 Fax: 310-641-2900 
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* ProMath/VB - numerics/statistics. $149 

* FinLib/VB - financial calculations. $149 

* SpellCheck/VB - spelling & lookup. $49 

* Dazzle/VB - image manipulation. $199 

* VBIite - print/comm/array/B-Tree index..$J49 

* VoxLib/Pro - multi-line telephony/callid .$799 

* BarMagic - bar code toolbox. $299 

* QB/C/dBase - 15 more DOS libraries ...$call 

* Custom - C, VB, ASM programming ,...S80/h 
Develop your VB app faster: Get TeraTech tools! Call, E-mail 
or fax us and we'll mail you a free demo disk ASAP. Or for 
faster service download by FTP or from our BBS. Call now! 

800-447-9120 ext. 1258 

Dept 1258, 100 Park Avenue, Suite 360, Rockville MD 20850 USA 
InfI: +1 -301 -424-3903 Fax: (301 )762-8185 BBS: (301 )762-8184 
info@teratech.com http://www.teratech.com/teratech/ 
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Demo / Tutorial / CBT / Presentation 


Visual Windows Automation 
Multimedia Authoring Development Kit 

G Use ShowBasic Recorder to generate the editable, 
mouse/keyboard simulation code invariant to window's 
size and position, screen resolution and video driver. 

Q Achieve visual control over external applications 
and unlimited flexibility by programming in full 
featured Basic extended with the unique presentation 
and CBT related functionality, use even access to 
external DLLs and Windows™ 16-bit or 32-bit API. 

CG Pack your application in a compressed executable 
with the small self-installed run-time and all supporting 
files (BMP, WMF, WAV. MIDI, AVI), compatible with 
Windows 3.1, Windows 95 and Windows NT . 

□ Deliver your titles transparently via WWW - j 

ShowBasic can be integrated with any WEB browser. 

Development license $299 with .V) day money back guarantee. Royally tree license $X9.5. 

If you don't need all the pow er of Show Basic - use our simple, 

yet flexible scripting language for live demos and automation: 

SmOiEIWIO JP^ TT - 

Single-user license $3(1 ($60 Pro). Royally free license $300 ($500 Pro). Visa/MC accepted. 

Find more information, demos, samples and evaluation copy: 

http://www.cnj.digex.net/~mik 

■ MIKSoft, Inc. tel/fax: 908-390-8986 

37 Landsdowne Road. East Brunswick NJ. 08816 
Internee mik@cnj.digex.net CompuServe: 74127.3671 
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XCEED ZIP 

COMPRESSION LIBRARY 


16 and 32-bit Delphi VCLs. VBX, OCX 


Finally, a compression component that 
gives you your money's worth! Add 
Xceed Zip to your project, set a few 
properties, and your apps will be ziping 
and unziping in minutes. Great for 
automating backups, preparing files 
for transmission, or developing your 
own custom installer. 



( 800 ) 865-2626 
( 514 ) 442-2626 


Visit www.xceedsoft.com dev for a 
free trial version and find out 
why Xceed Zip is rapidly becoming 
the most popular VB and Delphi 
compression library! 


, v Cash in on 
the Voice 
^ Bonanza! 


Get your piece of the $3 billion Voice Industry - 
develop your own Computer Telephony Apps! 


Add voice power 
to your Windows 
apps with TI/F 
DLL '" (CT Mag's 
Product of the 
Year), our popular 
interface to 
Dialogic™ multi- 
line telephony 
hardware. 


Audio Tool Box" 
lets you batch 
process and 
convert audio files 
to & from standard 
formats. Adjust 
volume, filter, trim 
silence, more! Add 
to your apps with 
ToolBox SDK. 


Call and ask about 
our VFEdif 
professional voice 
prompt editor, 
Scribe ™ trans¬ 
cription utility, 
VoxFonts™ text- 
to-speech library, 
plus more great 
products! 


f/si 800 - 469-4874 


VISI, 2118 Wilshire Blvd, #973, Santa Monica, CA 90403 
310-392-8780 Fax: 800-234-FXIT / 310-392-5511 sales@vinfo.com 
BBS: 310-392-6610 www.vinfo.com (Download Working Demos) 
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MAKE $500,000 
PER YEAR! 


-as a recruiter in the computer industry. 

Did you know that... 

• The average company paid fee is 
$12,500! 

• The average recruiter earns $200.000 
per year! 

• Placing just 4 people a year will make 
you more money than 98% of the 
population currently earns! 

You have the knowledge, you just don’t know 
the rules. For $19.95 plus $3 S&H I’ll show 
you how! Call the recording below for a full, 
detailed explanation of how you can finally... 
earn what vou are worth! 


earn what yo, 

KBL 


m 
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Business Applications 



Create mission-critical, multi-user 
business applications iVCWwith PRO/5™! 



* Easy to learn and use 
» Scaleable from 

1 to 1,000+ users 

• Windows 3.x/95/NT, 
DOS, Novell, and UNIX 

• Affordable 

* World Wide Support 

Call 1.800.423.1394 
info@basis.com 
http://www.basis.com/ 
BASIS International Ltd. 
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www.dice.com 


DICE is looking for Data Processing, Engineering and 
Technical Writing professionals to Fill open positions 
for companies nationwide. 

DICE is a FREE online job search service, providing 
detailed information about current contract and fulltime 
positions across the USA. Please contact by calling ANY of 
these access numbers, using your computer & 1200-9600 
baud Modem, 8-N-l. 


California. 

Georgia 

Illinois 

Iowa 

Massachusetts 
New Jersey 
Texas 
Internet 
Web 


408-737-9339 
404-523-1341 
708-782-0960 
515-280-3423 
617-266-1080 
201-242-4166 
214-691-3420 
telnet dice.com 
www.dice.com 


DATA PROCESSING 
I NDEPENDENT 

Consultant's $ 

E XCHANGE , 


A Service of D&L Online, Inc:. (515) 280-1144 
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MFC 3D Modeling Extensions 

Need to add 3D modeling capabilities to your 
new or existing MFC based products? MEX 
is a full featured, robust, no compromise 3D 
modeling application framework featuring: 
Object/Tool/Editor architecture 
Extensive math library 
Orthographic and Perspective views 
Import/Export facilities 
Unlimited Undo/Redo 
2D/3D Bezier Spline editor 
Mesh/Light/Camera editor 
Generalized Cylinder editor 
And much, much more. Windows 95/NT 
All four modules on\y.%]M (Personal) 
Call today: 914-267-2059 

Source A vailable Visa/MC/COD 

® B&F Software Solutions Inc. 

44 FoHim Way Congers, NY 10920 


□ Request Reader Service #149 


Dr. DeeBee 
ODBC Tools 


Tools for ODBC development 

Ever wonder why 
your ODBC app is not 
working? Why it’s just 
too slow? If the ODBC 
driver is OK? 

Dr. DeeBee utilities reveal the inner workings of ODBC. 



□r. DeeBee ODBC Driver Kit 



Connect proprietary databases to 
Access. Visual Basic, and PnwerBuilder 
with nur Dr. DeeBee ODBC Driver Kit 


-SYlWAEi - 

RO. Box 91 Kendall, Cambridge, MA 02142 
617 - 497-1376 Fax 617-497-8729 
http: //www. syware. com 
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2. Microsoft is missing an IMPLIES utility. 
But their LIB utility can create a . 1 i b 
file from a . def file. I do not have Visual 
C++ myself (so I cannot verify this), but 
in Matt Pietrek’s book Windows 95 
System Programming Secrets , the fol¬ 
lowing instruction appears (page 759): 

LIB /MACHIN: 1X86 /DEF:K32LIB.DEF 

Strangely enough, Matt Pietrek lists the 
functions with their decoration in the 
. def file (e.g. function 
“GlobalLockl6@4” on the bottom of 
page 756) whereas your example (page 
38) lists the undecorated name in the 
EXPORTS section. 

You probably knew this already. Sorry if 
I wasted your time. 


Watcom does have the most irritatingly 
non-standard set of command-line tools of 
any of the Windows compilers I know of. On 
the other hand, building DLLs tends to be a 
rat’s nest of incompatibilities, no matter 
what the compiler. The overwhelming 
majority of our readers tend to use either 
Borland or Microsoft, so I just didn ’t have 
the intestinal fortitude to figure out the oth¬ 
ers — thanks for the Watcom tip! 

It’s true that Microsoft’s LIB can build 
an import library from a .def file, but the 
problem is that only works if the .def file 
contains decorated names! That still leaves 
the problem I discussed in the article: given 
an arbitrary Win32 DLL, Microsoft gives 
you no tools for automatically creating a 
Visual C++ import library for that DLL. 


You would have to examine the declaration 
of each exported function, calculate the 
“mangled” name for it (don’t make any 
mistakes or it won’t work!), and hand-cre- 
ate the necessary .def file. It’s a lot easier 
to just use a non-Microsoft compiler like 
Borland C++, which does provide a Win32 
implib.exe so that you can easily create 
an import library for any DLL (not just 
Borland DLLs). Frankly, the way Visual 
C++ handles exported symbols is seriously 
brain-damaged, but I doubt it will ever 
change unless some other Win32 compiler 
becomes a serious competitive threat 
again. —rib 




The best high 
performance, 
portable 
compression 
libraries for 
DOS, Windows, 
OS/2, Unix, 
Macintosh, 
embedded systems, 
and practically anything 
else, period. 


FREE DEMO 

DOS $249 
Winl 6 $299 

Win32 $299 
OS/2 $349 
Unix $349 
Macintosh $349 

RJ DC Micro 
SSt Development 

Call 1-800 

info@dcmicro.com 


45-function API 
Buffer compression 
File compression 
Disk spanning 
Encryption 
Self-extracting EXE's 
VBX/OCX controls 
On-line help 
Full source code 
Tel 606-245-4175 
Fax 606-245-9305 

-775-1073 

http://www.dcmicro.com 
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Looking For Something? 


WinGREP can find it 

WinGREP is a multi-file search 
utility that can quickly locate text 
strings in source code files. 
Tight integration into over a 
dozen editors and integrated 
development environments 
(IDE's) sets WinGREP apart 
from other search utilities. 
WinGREP can be customized to 
automatically synchronize an 
editor or IDE with the results of a 
search. Not only does it open 
the file, but it will also position to 
the line of the match. The ability 
to display the results of a search 
in a programmer's native work¬ 
ing environment makes main¬ 
taining volumes of source code 
a manageable task. 



. ■ 


i.'sr”' 


Regular expression 
button bar 




v Optimized for programmers 

✓ Very fast search performance 

✓ Save, load, and print results 
v Easy regular expressions 

v Long file names 

✓ UNIX text file support 

v Quantity pricing available 


Trial Version Available 

$39 + 4SH(US) 
Toll Free 24hrs (US) 

(888) 946-4737 


Hurricane Software, Inc. 

www.hurricanesoft.com • CompuServe go WINUTIL 
e-mail mail@hurricanesoft.com • CompuServe 102470,2564 
2401 SE 7th • Blue Springs • MO 64014 • (816) 373-9252 
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WINDOWS 

DEVELOPERS 

Call 800-638-8903 

w i 

As a headhunter focusing exclusively 
on Windows developers, I can often 
find the best opportunities. Through 
constant networking I learn of 
positions all over the country. All fees 
are paid by the client company. The 
market is excellent for talented 
windows developers. 

Email me at gvp@cmagroup.com 
— Gary Patton 

Sareer 
MARKETING 
0SSOCIATES 


www.cmagroup.com 
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COPY PROTECTION 

INTERNET ACTIVATION 

Az-Tech Software, Inc. 

Leaders in Software Security 
INTERNET 
CPU-LOCK 
HDD-LOCK 

CD-ROM LOCK (Software Based) 
REMOTE ACTIVATION 
EXECUTION LIMITS 
LIMITED INSTALLS 
REMOTE RESETS 
SERIALIZATION 
REGISTRATION (Secure Distribution) 

ACCESS FLAGS 




DATE LIMITS 
NET LIMITS 
"POINT & SHOOT" 
WIN95*3.11*DOS 







(Hardware Based) 


Phone: (816) 776-2700 x320 
Fax: (816) 776-8398 * Dept: SMG-320 

Internet: www.az-tech.com -- 

_ E-Mail: sales@az-tech.com 120 
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Reach the core of the 
Windows programming market: 


Windows 


DEVELOPER S JOURNAL 


The Magazine for Windows Programmers 

The ONLY independent magazine 
that focuses exclusively on the 
"nuts and bolts" of building 
sophisticated Windows applications. 


Put your tools where 
professional Windows developers 
go when they need advanced 
information about developing 
Windows applications - Call today! 


I Ed MacMillan - East I Daniel Lassley - West 
913-838-7513 I 913-838-7541 

I breakout! marketing - Continental Europe 
+49 431-801740 

www.wdj.com 
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ACCUSOFT 
IMAGE , M 
GUARANTEE 


Ava 




ImageGear™ 6.0 shifts your development schedule into 
warp drive by providing you with the most 
comprehensive, easiest to use image processing solution 
available. With support for over 45 file formats and an 
API featuring 200 plus functions, ImageGear is the 
toolkit that no developer should be without. 

Standard and Pro Gold™ versions allow you to purchase 
the level of performance and functionality you need. 
ImageGear offers the high speed display of both bitonal 
and full color images with functions like scale-to-gray, 
automatic aspect-ratio correction, panning window, 
magnify window, and much more. Advanced features 
like auto-deskew, sub-pixel display accuracy, rotate to 
any angle, and special effects add robust image 


processing to any application. ImageGear's new display 
technology is fast and easy to use and printing is more 
accurate than ever with new high-level functions. The 
TWAIN scanning interface with support for 32-bit 
drivers gives you complete control. GUI functions 
make integration quick and seamless, and multi¬ 
platform support provides a complete solution to 
portability issues. 

The AccuSoft Image Guarantee™ assures that your 
application will read every valid image. You can turn to 
us with confidence because we have over ten years of 
experience as the leader in quality image processing. 

So call the experts at AccuSoft, and step up to the next 
level in quality and performance with ImageGear. 


Visit our Website @ www.accusoft.com 

40k FREE ImageGear 6.0 Demo Jttt Comprehensive Product Info 
4Bk ImageGear Special FX in Action Jttfc Imaging Toolkit Glossary and Much More! 
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The Next Generation of Imaging Technology for Developers 


Scan, Display &^rint 
Document Imaging 
Scale-to-Gray 


. ...v> 


A 

*. ->.T __ L V\ 


. _ Ji, . 


gF* ^ ^efelSI Efte^s , 

W&& and Much More! * 
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Windows 
Win95/NT 
MIPS NT 
Alpha NT 
VBX 

ActiveX(OCX) 

OS/2 

SUNOS 

Solaris 

HP-UX 

AIX 

SGI 

SCO 

MAC 

PowerMac 


C~rrtr ££ Fffc 
Perris 


TIFF 
JPEG 
PCX 
JFIF 
TGA 
Group 3 
Group 4 
PGM 
DIB 
IMT 
DCX 
BMP 
KFX 
RLE 
LV 

CALS 
ATT 
CLP 
XWD 
XBM 
IFF 
SUN 
PNM 
IOCA 
GX2 
XPM 
ASCII 
CUT 
GEM 
BRK 
MAC 
PSD 
MSP 
PNG 
PCD 
IMG 
IGF 
SGI 
ICO 
PBM 
PPM 
MO:DCA 
WMF 
WPG 1 
PICT 1 
EPS 1 
GIF 2 
ABIC 3 
CIF 3 
JBIG 3 
DICOM 3 
and others 


MINUTE 


Delivery 


WD5 


AccuSoft Corporation 

Two Westborough Business Park 
Westborough, MA 01581 
Tel (508) 898-2770 
FAX (508) 898-9662 


AccuSoft 

High Performance Imaging 

Call for FREE Demo! Toll Free: (800) 741-7720 
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The comprehensive imaging toolkit 


Import/export and display 
40+ image file formats 



LEADTOOLS PROFESSIONAL EXPRESS 


. MEW LEADTOOLS ncisvitt evcryrtanf you ot*d to i 
2. 1 B4W dacuBert »»go^ to gptyxctU irasgir.g, to le l 
C 3 toofat debvti s owi 200 fcoction* to i«*4 mat, t cisju 
"T MX pnM, & mow. Ifw feaure*ncMt tnMUtxx 
-fi Alt formats. -Vah fat new irdrouJ n»:+iUi 4*0 $i you 
specific dtvstopiMt* scenario tod fctep fat rot of jour *ppl 


Processing <x« --yi 

touts ( 01’;, dtp, ur.**^ 
mtonsety deled, stretch si 
mos sc, fa»«, posterns, * 


Get to LEAD'S FTP at© 
j and check th© list out 


Region of interesi 

Von can specify retpoia 
cm be composed of my 
Polygpns, & raose 


-- 


NEW! 
Annotation 
features include: 
add text, 
highlighter, 
sticky notes, 
ellipses, 

rectangles, lines, 
free hand 
scribbling, 
redaction, 
buttons, hot 
spots, pointers, 
audio, bitmap 
stamps, polylines, 
polygons, and 
more. 


/ Formats & 


BMP 

IMG 

MSP 

TGA 

CAL 

I0CA 

PCD 

TIFF 

DIB 

JPEG 

PCT 

VDA 

EPS 

JFIF 

PCX 

VST 

FAX (raw; 

JTIF 

PNG 

WINFAX 

DCX 

LEAD CMP 

PSD 

WMF 

GIF* 

MAC 

RAS 

WPG 

NEWI Progressive JPEG & CMP 

NEW GIF "flavors" i Kodak's FlashPixl 

Partial lis 

full details at 

ur new 

Web site. 


e cosf-ditntei-C'iii 
"OH"** E»j) 

Scanning 5ajy>i>jt» 16 & 32 twt TWAIN interfaces for dtsvmg lh» most popular scmning tower 


• Cravetsios txptnd or reduce an image's color depth mlh raj 
faqioi optawadp«l»Ute Separate/reconstruct anmug* tq|IR3tWid>YidU4j ROB, CMYK 
CMV, H3+Nq£HSL colot planes LEADTOOLS also iH'UjFJWW^NX 11 ITi 11* mu i mtfc 

rotated screens 


ffewnz ficcUons including reset. interpolated reset, 
poet, fin chjxptn, btur. brighten. darken. Hut & s star alien. 
R, gamma correct, histogram equalize, edgt detect hue detect. 
«« filtei, spdral fillet ijgradrent lapiactan, scfcel. ptewtU, fhrfl ti 
r, d*rpedde.& more You can even use Windows ODI 


practical aitomi ■fla">r5 J /il l Wfi3Tp"ef l 3eplIe" 1 
bMp/Zwitw leadloolt comtformaLs him - 

Compression No other toolkit offers as marry compression options including CC1TT 03 & 04, 
CompuServe's new lossless PNG. JPEO and LEAD* otro proprietary 'CMP LEADTOOLS deir/ets the 
fastest software only JPEO algorithms The CMP format results m smaller file roes an! maintains batter 
image quality than industry standard costpiesaan formate 

Printing LEADTOOLS 6 performs all the image processing necessary to print to any pnrder utth the 
highest quality and has fa* capability to print fed and multiple images on fee same page 


40+ processing 
features 
including: 
rotate, resize, 
crop, transpose, 
reverse, sharpen, 
blur, brighten, 
darken, hue, 
saturation, 
intensity, emboss, 
contrast, mosaic, 
posterize, line 
detect, edge 
detect, histogram 
equalize, median 
& noise filter, 
spatial filter 
(gradient, 
laplacian, sobel, 
prewitt, shift and 
difference, line 
segment), 
underlay, 
autodeskew, 
despeckle, and 
more. 


NEW! Use region processing 
on a specific area in an image 


Image is everything! Take advantage of the same imaging technology 
that is utilized by Corel, AT&T, McDonnell Douglas, Xerox, Sharp, 
Delrina, Microsoft, and others! The combination of LEADTOOLS 
mature and stable code, together with the rich image processing 
features, our extensive file format support and industry leading 
compression options, makes this toolkit the only choice to integrate 
imaging into your application. Whether you choose one of the 
LEADTOOLS Pros or LEADTOOLS Pro Express, you are guaranteed 
the most comprehensive imaging solution available! 

The award-winning LEADTOOLS 7 is everything developers need to 
integrate black & white, grayscale, and color images into any 
WIN16/32 or OS/2 application. Our toolkits provide 200+ functions, 
with the following capabilities: importing and exporting of 40+ file 


formats, rich image processing, region of interest, color conversion, 
fast image compression, scrolling, zooming, dithering, printing, 
scanning, data base support and annotations. With our new internal 

modular design, you can select the components you need for your 
specific development scenario and keep the size of your application to 
minimum. The toolkits provide both high-level and low-level 
functions, and ships with example application source code. 

If you need imaging, you need LEADTOOLS. 


“LEADTOOLS is an indespensable tool - we 
used it in the development of our FrontPage 
application." 


- Tom Button, Director of Marketing, 
Internet Platform & Tools Division, 
Microsoft Corp., 7/96 


“LEADTOOLS is a fine example of excellent 
technical skills, marketing, and good design 
combining to make an excellent tool. 


- Don Rogers, 

VB Tech Journal, 
June, 1996 


Download FREE 
imaging application built with 
NEW LEADTOOLS 7! 
or call 

800 - 637-1847 

□ Request Reader Service #102 □ 


WINDOWS 95 I WINDOWS NT I WIN32S 


Everything You Need To Know About Imaging 


http://www.leadtuols.com/ 
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WINDOWS 

OS/2 

DOS 

▼ INCORPORATED 

C/C++ 

MFC 

1 VISUAL BASIC 




900 Baxter St. Charlotte, NC 28204 704-332-5532 Fax:704-372-8161 CompuServe: "GO LEADTECH" 

| LEADTOOLS is available in several versions, not all features are available in all versions. 1 

| ' License required from Unisys lot formats using L2W compression LEAD and LEADTOOLS ore tegistered trademarks of LEAD lechnologies. Inc All olhet product names me trademarks of then respective ownets. | 




VBX 

ActiveX 16/32 

DLL 16/32 

ACCESS 

DELPHI 

VISUAL FOXPRO 

































































